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THIS MANUAL . . 



contains the information necessary to install and use POWER/ VS. A good knowledge 
of DOS/VS is required. 

The following parts make up this manual: 

• Introduction. An overview of the purpose and features of POWER/ VS. 

• POWER/VS Concepts and Facilities. Includes the concepts and defines the 
terminology of POWER/VS. It also lists the hardware devices supported. 

The terms defined in this section, especially those under the heading "Organization 
of the POWER/VS Data and Queue Files", should be studied carefully. They must 
be understood to use this manual effectively. 

POWER/VS Generation. Describes how to tailor POWER/VS using the generation 
macros. Also described is the supplied, pre-assembled version of POWER/VS that 
will make generation unnecessary for many users. 

POWER/VS Start-Up. Contains the POWER/VS start-up procedures and describes 
the AUTOSTART facility. 

Job Entry Control Language (JECL). Describes the JECL statements, which are 
used to specify job requirements to POWER/VS. 

POWER/VS Operator Command Language (POCL). Describes the commands used 
by the central operator to communicate with POWER/VS. 

Remote Operator Command Language (ROCL). Describes the commands used by 
the remote terminal operator to communicate with POWER/VS. 

POWER/VS Operator Messages. Contains all the POWER/VS messages that might 
be printed at SYSLOG, SYSLST, or a terminal. 

Appendixes. Contains tables referenced in the body of the manual or information 
of interest to only certain users of POWER/VS. Refer to the table of contents. 

Index. 



NOTATION CONVENTIONS 



Uppercase letters, numbers, and punctuation marks must be coded exactly as shown. 
Operator commands may be entered in uppercase or lowercase letters. 

Lowercase letters and words represent information that must be supplied by the 
programmer or operator. 

Options contained in braces } ( represent alternatives, one of which must be 
chosen. 

Brackets [ ~\ indicate that the element they enclose is optional. The brackets should 
not be coded. 

Stacked options contained within brackets [^] represent alternatives, one and 
only one of which may be chosen. 

Default values are underlined. 

No comma is used before the first parameter specified. 

Keyword parameters consist of a keyword, followed by one or more values. 

Positional parameters must appear in a specified location, relative to other 
parameters. If a parameter is omitted, its absence is indicated by a comma. Trailing 
commas are not required. 
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INTRODUCTION 



In all computing systems, electronic CPUs are very fast, whereas the largely mechanical 
unit-record input/output devices (card readers, card punches, and printers) are relatively 
slow. Because of this fact, the overall duration of most programs is largely dependent 
on the speed at which unit-record I/O can read and write data. 

To reduce CPU dependency on unit-record devices, the technique known as spooling 
(Simultaneous Peripheral Operation On Line) was developed. Spooling separates the unit 
record input/output operations for a program from the execution of that program. Under 
control of a spooling program, such as POWER/VS, card input is first read and placed 
on intermediate disk storage. Then during execution of the problem program, data is 
read from and written to intermediate storage; program execution does not have to 
wait for unit record I/O operations. After execution, printing and punching are done 
while other problem programs are executing. 

POWER/VS (Priority Output Writers, Execution processors, and input Readers/Virtual 
Storage) is a spooling program that also includes job scheduling. Besides reducing CPU 
dependency on the relatively slow speeds of card readers, card punches, and printers, 
POWER/VS executes each job according to its user-assigned priority and class. 

Job processing under POWER/VS can be controlled at various stages by the operator. 
For example, jobs entered into the system can be held on disk and not executed until 
released by an operator command. Similarly, the operator can defer (hold) large-volume 
output queued for printing or punching to prevent the tie-up of printers and punches 
when the system is busy. 

The time and resources that can be saved processing a job stream with POWER/VS 
is illustrated by Figure 1. 

The upper part of the figure shows the processing of a DOS/VS job stream in a partition 
without POWER/VS spooling facilities. Job B, which prints a great deal, slows down 
throughput. Notice that without POWER/VS, the reading and printing devices are 
logically committed to the partition for the entire duration of the job stream. 

The lower part of the figure shows the same job stream processed (in a single 
user-partition) with POWER/VS. Processing is shown divided into reading time, CPU 
time (execution), and printing time. The vertical broken lines are used to connect the 
reading, execution, and printing stages of each job. The horizontal broken lines represent 
time spent by the jobs in the respective queues awaiting execution or printing. Print 
(or punch) queue wait time can be reduced by segmenting output (see "Attributes" in 
"POWER/VS Concepts and Facilities"). Punching and punch queuing is omitted from 
the example for the sake of clarity. 

Figure 1 shows that POWER/VS improves overall system performance in several ways: 

• Total elapsed time is reduced. 

• Resources are made available as indicated in the lower part of the figure: 

The reader is free to read more jobs as soon as job E is entered into the 
input queue. 

The partition is available before job A and after job E are executed. 

The printer has some spare capacity that can be used to print output from 
other job streams. 



Introduction 1, 1 



*° WITHOUT POWER/VS 



Q 



sr 

CO 

g 

o 

3 



9 

§ 



WITH POWER/VS 



READING 



EXECUTIONS 



PRINTING 




Batch partition finished 



Figure 1. Processing Jobs A - E With and Without POWER/VS 
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POWER/VS FEATURES 



Design 



POWER/VS runs in virtual mode, which reduces its real storage requirement. 

A large portion of POWER/VS code is re-entrant, which reduces page-out activity. 

The POWER/VS generation procedure is simple. If the IBM -supplied, pre-assembled 
program fits installation requirements, generation is not necessary. 

Writer-only operation is specified by partition at POWER/VS start-up or during 
operation. It is not necessary nor possible to generate a writer-only POWER/VS 
program. 

Up to four partitions can be controlled by POWER/VS. Each partition is separately 
initiated. The user does not specify these partitions at POWER/VS generation time. 

Automatic start-up of POWER/VS is provided through control cards. 

Device error recovery is provided. Only the affected POWER/VS task is canceled 
on an unrecoverable I/O error. 

POWER/VS code is modular for easier maintenance. 

Programs can be executed under POWER/VS in either real or virtual mode. 

Up to five disk volumes are supported for POWER/VS intermediate storage. 

Tape intermediate storage can be used for output. 

Up to eight printers and eight punches, whether physically present or not, can be 
defined for each partition. 

POWER/VS can be shut down and restarted without losing jobs queued for 
execution or output queued for printing or punching. 

POWER/VS job accounting records contain spooling activity information, the 
complete DOS/VS job accounting table for each job executed, and summary sign-on 
information for RJE lines. 



Job Management 



POWER/VS job queues are partition independent; regardless of the number of 
partitions controlled, POWER/VS maintains only one read queue, one list queue, 
and one punch queue, giving greater scheduling flexibility. 

Priority scheduling support is provided for up to ten priorities. 

Jobs can be assigned input and output classes so that jobs requiring the same 
resources for execution or output can be grouped together. 

The default job class, which is assigned to a POWER/VS job when no class is 
explicitly assigned, can be changed at any time. 

A job entry (execution or output) can be flushed without deleting it from the 
POWER/VS queues. 

Jobs that are to be executed repeatedly can be kept in the input queue after 
execution. 

Source library inclusion is supported, allowing DOS/VS job control and data to 
be called from the source statement library (system or private) by POWER/VS 
job entry control statements. 

Keyword parameters in POWER/VS job entry control statements reduce errors and 
also provide documentation of processing requirements. 
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I/O Management 



Multiple print and punch classes are supported. 

Restart capabilities are provided for printed and punched output. 

The listing or punching of output for a job can be started before all list or punch 
output for that job has been spooled (output segmentation). 

The user can defer the printing or punching of output. 

Output, after it is processed, can be retained in the queue so that additional copies 
can be obtained. 

The punched output of a job (e.g., an assembly) can be returned directly to the 
input queue from the output queue. 

Output from jobs entered at a local card reader can be routed to a remote user. 

Output from jobs entered by a remote user can be routed to the central site or 
to any remote user. 

Special card stock can be specified and changed during punching of output. 

Special forms can be specified and changed during printing of output. 

Printer output can conform to special printer carriage control tapes. 

FCB and UCS buffer loading is supported using DOS/VS JCL and/or POWER/VS 
JECL. 

A limit can be placed on the number of list or punch output records that 
POWER/VS accepts from a job. 

A job separator facility is provided for printed and punched output for both local 
and remote jobs. 

Job streams placed in the reader during execution of POWER/VS are read imme- 
diately. 

Output can be printed/punched directly, without being spooled. 



Operator Facilities 



The central operator controls POWER/VS activity. He can display job status, release 
jobs from hold status, alter job priorities, delete jobs from queues, terminate jobs 
in progress, and can start and stop readers, writers, and RJE system components. 

Partitions, tasks, or jobs can be initiated at any time. 

The central operator can direct output to a local output device or to a specific 
remote user. 

Job disposition can be obtained or changed, and jobs can be deleted from the 
system by both the central operator and the remote terminal operator. 

Output can be discontinued, restarted, or canceled by either the central operator 
or the remote terminal operator. 

The status of any job or group of jobs can be displayed or altered. 
Printer set-up facilties are provided to allow proper form alignment. 
Messages can be broadcast to all RJE users. 
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Remote Job Entry (RJE) Facilities 



The RJE commands are a subset of the central operator commands. 

System security is provided by password and user identification. 

The central operator has inquiry facilties to determine the status of any or all 
RJE lines. 

The idle time allowed a terminal (before it is automatically signed off) is specified 
by line during POWER/ VS generation. 

"Hot reader" support allows a terminal to send, without operator intervention, 
as soon as the terminal is ready and the line is available. 

"Hot writer" support allows a terminal to receive, without operator intervention, 
as soon as output is queued at the central processor. 

RJE write tasks can be started by the remote operator, acting independently of 
the central operator. 

Remote job output can be requested only by the user submitting the job. However, 
the user can direct output to the central system for output processing or optionally 
retrieve a portion of the output, inspect it, and then direct it to the central site. 

The remote terminal user can send messages to and receive messages from the 
central site or another remote terminal. 

Up to 25 RJE lines can be active concurrently. 

ASCII support is provided. 

Data can be transmitted to the central site in either transparent or non-transparent 
mode. 

Hardware support is provided for horizontal tab, space compression/expansion, 
buffer expansion, additional buffer expansion, and the multiple record feature. 
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POWER/VS CONCEPTS AND FACILITIES 



POWER/VS TASKS 



POWER/VS is a reader/writer program that provides automatic staging of unit record 
input and output, class scheduling, and priority scheduling for all DOS/VS programs. 
User programs and DOS/VS job control statements can be processed by POWER/VS 
without modification. 

Figure 2 shows the program elements and the data flow of POWER/VS: 

• The job streams (POWER/VS control statements, DOS/VS job control statements, 
programs, and data cards) are read and stored in the read queue and POWER/VS 
data file. 

• The jobs are scheduled and executed from the read queue and data file. 

• Output is stored in the list and punch queues and POWER/VS data file before 
it is finally printed and/or punched. 

• Readers, writers, and partitions are started and stopped, and job processing is 
controlled through operator commands entered from the console. 

POWER/VS resides in one partition of a DOS/VS system and controls from one to 
four other partitions, each having a lower dispatching priority than the POWER/VS 
partition. POWER/VS is executed in virtual mode to take advantage of the virtual storage 
environment provided by DOS/VS. User programs execute under POWER/VS control 
in either virtual or real mode. 

The control statements and input data required for program execution are read by 
POWER/VS from the appropriate unit-record reader, and written to intermediate direct 
access storage, where they remain until requested by job control or the user program. 
During program execution, each program request for unit-record input addressed to the 
device specified at start-up in the READER statement is intercepted by POWER/VS, 
which simulates a read operation by providing a data record from intermediate storage. 
Therefore, unless input is read directly by the user program, stacker selection of input 
data cards is not possible; POWER/VS ignores such requests. Similarly all unit-record 
list and punch output directed to device addresses specified at start-up in the PRINTERS 
and PUNCHES statements is intercepted by POWER/VS and written to intermediate 
storage (disk or tape). Such output records remain in intermediate storage until 
POWER/VS writes them to the appropriate unit record list or punch device. 



POWER/VS performs four basic functions. They are: 

• Read. A user job stream; composed of DOS/VS job control statements, optional 
POWER/VS control statements, and program input data; is read from a peripheral 
device, normally a card reader, and written to intermediate direct access storage. 

• Execute. Each user job submitted is executed under the control of POWER/VS. 

• List. The list output generated by the user program is written from intermediate 
direct access storage or tape to a printer. 

• Punch. The punch output generated by the user program is written from 
intermediate direct access storage or tape to a card punch. 

In order to perform these functions concurrently, POWER/VS is structured into a series 
of asynchronously executed tasks. All necessary task support is provided within 
POWER/VS. Multitasking support within the DOS/VS supervisor is not required. 
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Figure 2. POWER/VS Program Elements and Data Flow 



The POWER/ VS tasks are: 

• Main Task. It initiates and terminates POWER/VS execution. 

• Line Manager. It controls all teleprocessing line activity. 

• Command Task. It handles all commands submitted by the system operator, and 
initiates and terminates other POWER/VS tasks. 

• Wait Task. It transfers the POWER/VS partition to and from the wait state. 

Note. The main task, line manager, command task, and wait task are internal "control 
tasks ". The following are "Junctional tasks ". 

• Read Tasks. They perform the read function. The operator can call for concurrent 
execution of as many read tasks as he has physical readers available. 

• List Tasks. They perform the list function. The operator can call for concurrent 
execution of as many list tasks as he has physical printers available. 

• Punch Tasks. They perform the punch function. The operator can call for 
concurrent execution of as many punch tasks as he has physical punches available. 

Note. Read, list, and punch tasks are collectively referred to as "read/write tasks. " 

• RJE Tasks. They consist of read, list, and punch tasks. One read, one list, and one 
punch task per line can be active concurrently. 

• Execution Read Tasks. They provide simulated reader support for the execute 
function. There is one execution read task active for each partition under 
POWER/VS control. 

• Execution List Tasks. They provide simulated printer support for the execute 
function. An execution list task is automatically initiated when* required by a user 
job. 

• Execution Punch Tasks. They provide simulated punch support for the execute 
function. An execution punch task is automatically initiated when required by 
a user job. 

Note. Execution read tasks, execution list tasks, and execution punch tasks are 
collectively referred to as the "execution processor". 

Each read task is divided into two parts: physical read which performs the actual reading 
of the data from the card reader, and logical read, which saves the input data in the 
POWER/VS data file and creates a new entry in the queue file. 

Each list task is divided into physical list and logical list. Logical list retrieves data 
from the list queue and passes it to physical list, which performs printer device dependent 
functions. Similarly, each punch task is divided into logical punch and physical punch. 
Figure 3 is a simplified illustration of the sequence in which functional POWER/VS 
tasks are executed to process a job. 



POWER/VS DIRECT ACCESS FILES 



The intermediate disk storage used by POWER/VS is divided into three files: queue 
file, data file, and account file. 

Data file records contain the spooled input and output data. Queue file records describe 
the processing requirements of each job and "point to" the job's associated data in 
the data file. The account file contains accounting information, and is optional. 

The following defines the logical organization of POWER/VS direct access storage. Refer 
also to Figure 4. 
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Organization of the POWER/VS Data and Queue Files 



Queue File 



Data File 



POWER/VS breaks the input stream up into a series of discrete jobs, and assigns each 
a sequence number. Each job is described by one or more read queue records in the 
queue file to form what is called a read queue set A read queue set together with 
its corresponding data in the data file form a read entry. File organization for list and 
punch output is similar to that for input; that is, POWER/VS generates list queue sets, 
punch queue sets, list entries, and punch entries. See Figure 4. 

A single POWER/VS job may create multiple fist and punch entries because of one 
or more of the following conditions: 

• Multiple LST/PUN statements occur within the POWER/VS job. 

• Multiple printers or punches are used by the DOS/VS job. 

• A user program(s) issues an LFCB (load forms control buffer) macro instruction(s). 

• Count-driven segmentation is used. 

List and punch entries are further divided into list entry segments and punch entry 
segments if the segmented output feature is used. Figure 5 shows, through a job stream 
example, how list entries and list entry segments are created. 

The three types of queue sets are logically assembled into three corresponding queues: 
the read queue, the list queue, and the punch queue. These three queues service all 
of the partitions running under POWER/VS control. 

The read queue is also referred to as the input queue. The term output queue is used 
to refer collectively to the list queue and the punch queue. Job entry is a general 
term referring to what could be a read, a list, or a punch entry. 

A description of all the POWER/VS files is maintained in a master record which is 
the first record of the queue file. In the event of a failure of the system, "warm start" 
information is recovered from the direct access files through the master record. 

During POWER/VS execution, a copy of the master record is maintained in the queue 
control block in main storage. As the contents of the queue control block change, 
the master record is updated. 



The master record and the queue records make up the queue file, a single extent of 
direct access storage. The logical unit SYS001 is assigned in the POWER/VS partition 
for this file. The file is assigned the standard file name IJQFILE. The user must supply 
// DLBL and /•/ EXTENT statements for the POWER/VS queue file. Split cylinders are 
not supported. Each record is 152 bytes long. 



The problem program input and output records are contained in the POWER/VS data 
file. It is assigned the standard file name IJDFILE. The user must supply // DLBL 
and // EXTENT statements for this file. One to five separate extents can be assigned, 
using logical units SYS002 to SYS006 within the POWER/VS partition. Each extent 
must start on a cylinder boundary and must contain an integral number of cylinders; 
split cylinders are not supported. All data file extents must be on separate volumes but 
assigned to the same type of direct access storage device. 
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Figure 4. Queue File and Data File Organization. This example is a logical re- 
presentation of the queue and data file entries generated by a POWER/VS job 
called Job A. One list entry shown is segmented. 
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The space assigned to the data file is managed by dividing it into units called track 
groups. The track group is the basic unit of space allocation used by POWER/VS. 
Each track group contains an integral number of tracks. The track group size can vary 
from a single track to an entire cylinder of direct access storage. When a cold start 
is performed, an appropriate track group size is chosen by the system based on the 
amount of disk storage provided. The user can specify an explicit track group size during 
POWER/VS generation. However, if the queue file is not large enough to describe the 
entire data file with this track group size, POWER/VS will determine a new track group 
and inform the user with a message. 
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Figure 5. Entries and Entry Segments. POWER/VS creates a new list entry for 
each LST statement processed or LFCB macro executed. A list entry segment is 
created each time record count exceeds the "RBS=" value. 
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Account File 



Each track group in the system has a corresponding queue record. Therefore, the total 
number of queue records must be equal to or larger than the total number of track 
groups. If not, part of the data file cannot be used. 

The data of each job entry type (read, list, or punch) occupies only as many track 
groups as are required to contain it. These track groups are not necessarily contiguous. 

The physical length of the records written to the data file is called the data block 
size. When a cold start is performed, an appropriate data block size is inserted by 
POWER/VS. The user can, however, specify an explicit value during POWER/VS 
generation. 



Accounting information is collected both from the POWER/VS partition and from the 
DOS/VS job accounting interface (JAI) and is placed in the account file together with 
full identifying information. The user does not have to provide his own job accounting 
routine. However, a routine can be written to include additional information in account 
records. See Appendix F. 

To use POWER/VS accounting support: 

• Specify JA=YES or JA=(nl,n2,n3,n4,n5) in the FOPT macro during DOS/VS 
supervisor generation. 

• Specify ACCOUNT=YES in the POWER macro. 

• Provide // DLBL and // EXTENT statements for the account file, using logical 
unit SYS000 within the POWER/VS partition. The standard file name is IJAFILE. 



The POWER/VS account file can contain six types of records. Their contents are detailed 
in Appendix A. 

• Read account record. Created for each entry written on the read queue. 

• List account record. Created for each list entry processed by a list task. 

• Punch account record. Created for each punch entry processed by a punch task. 

• Execution account record. Created during program execution on the basis of one 
record per job step. 

• Line account record. Created for each RJE user session. When the session is 
terminated, the record is written to the account file by the SIGNOFF processor. 

• Stop record. A special line account record written when the teleprocessing line 
is stopped by the central operator. 



Records are written to the account file in chronological order. After a warm start of 
the account file, new account records are written after the last record of the previous 
session. The user is responsible for sorting records and summarizing them to meet his 
own particular accounting requirements. The account file is a standard DOS/VS 
sequential disk file with variable length unblocked records, which can be processed by 
DOS/VS SORT/VS. 

The POWER/VS account file can be processed directly (after termination of 
POWER/VS), or the file can be saved on another medium via the PACCOUNT command. 
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JOB ATTRIBUTES 

The attributes of a job entry determine how it will be processed. The major classes 
of attributes are: disposition, class, priority, output segmentation, output limitation, 
output destination. 

• Disposition. Disposition determines how POWER/VS will route and schedule the 
associated input or output job entry. The possible disposition attributes are: 

D Process and delete. The job entry is automatically scheduled for processing 
by POWER/VS in accordance with its class and priority attributes. After 
processing, the entry is deleted and associated data space is freed. 

H Hold. The job entry remains in the queue; it is not executed or written to 
a unit record device, by POWER/VS until the operator releases it using the 
PRELEASE command or until he changes the disposition attribute to D or 
K by means of the PALTER command. When the PRELEASE command is 
used, the job entry, after it is processed, is deleted from the queue and asso- 
ciated data space is freed. 

K Process and keep. The job entry is automatically scheduled for processing 
by POWER/VS in accordance with its class and priority attributes. On 
completion, the job entry is not deleted from the queue, and the disposition 
of the entry is changed to L. 

L Leave in queue. The job entry remains in the queue; it will not be processed 
by POWER/VS until the operator releases it using the PRELEASE command 
or until he changes the disposition attribute to D or K by means of the 
PALTER command. When the PRELEASE command is used, the job entry, 
after it is processed, returns to the leave state. 

, c> p Three additional dispositions apply only to output: 

C ^ I: (< y '" I Return output to input queue. This option should be used only for jobs 

t? producing punch output in executable format; that is, including JCL. 

N Output without spooling. Output is not intercepted but is immediately printed 
or punched. 

T Spool to tape. Tape intermediate storage is used. 

D,H,K,I and L are valid only when output is spooled to disk. N and T are invalid 
when output is to be printed at a terminal. 

• Class. Class is a designation given to each job in a group of jobs that use a common 
set of system resources. These common resources might include: a partition size 
requirement; a high partition dispatching priority; or special printer forms, character 
set buffer, or card stock. 

Each job has a class attribute for execution and another for output. Input class 
is specified by an alphabetic character, A through Z, or by a number, through 
4. When specified as a number, input class is partition dependent; to 4 correspond 
with partitions BG to F4, respectively. Output class is specified by an alphabetic 
character, A through Z. Input and output classes are completely independent of 
each other. 

As compared to DOS/VS POWER, which has partition dependent queues, 
POWER/VS has only one read queue, one list queue, and one punch queue, which 
service all partitions. A single read queue, makes it possible for a job to be executed 
in any one of four partitions, which helps balance the work load among the 
partitions. Also, having partition-m dependent queues means that the operator 
spends less time starting and stopping readers and writers. 

When a partition is started, one to four classes are selected for execution in that 
partition. Classes are prioritized in the same order they are specified. 
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Priority. Besides the priority determined by its class, each job is also assigned a 
scheduling priority within its class. Priority is specified as a digit from to 9. 
Nine is the highest priority. If the priority is not specified, a default is assigned 
as defined in the PRI parameter during POWER/VS generation. Within each input 
or output queue, job entries are selected for processing on a first-in, first-out basis 
within priority, within class. 

Output segmentation. List or punch output from user programs can be broken 
into segments. Printing or punching can then begin before execution of the program 
is completed; that is, after the first segment has been spooled. Segmentation is 
done by record count, which is specified through the POWER generation macro 
or through the LST or PUN statement. 

Output limitation. A limit can be placed on the number of list or punch records 
(STDLINE or STDCARD parameter in the POWER macro or RBM parameter in 
the LST or PUN statement) that POWER/VS accepts from a specific job. When 
this limit is reached, (for example, 1000 lines have been printed) a warning message 
is given to the operator. 

Output destination. List and punch output can be routed to any terminal or to 
the central location by using the remote-id in the LST and PUN statements. 



POWER/VS CONTROL LANGUAGE 



POWER/VS job entry control language (JECL) is used to delimit POWER/VS jobs and 
to specify special job requirements. Specifically, JECL can be used to control the 
attributes of job entries, to load forms control buffer and Universal Character Set images, 
and to insert source statement library data into the input stream. JECL supplements 
the DOS/VS job control language (JCL); the JCL statements required for normal DOS/VS 
operation are also required when POWER/VS is used. 



POWER/VS OPERATOR COMMANDS 



The POWER/VS operator command language (POCL) allows the central operator to 
communicate with the system. A separate but very similar remote operator command 
language (ROCL) is provided for the remote terminal operator. The types of commands 
are: 

• Task management commands. Allow the operator to initiate and terminate 
POWER/VS tasks. 

• Queue management commands. Allow the operator to display and modify the 
contents of POWER/VS queues. 

• Miscellaneous commands. Allow the operator to perform such operations as forms 
| set-up and saving of the account file. 

• Terminal control commands. Allow the remote operator to initiate and terminate 
POWER/VS RJE tasks and to display and modify POWER/VS queues. 



INTER-PARTITION DEVICE ASSIGNMENT 



POWER/VS, as opposed to DOS/VS POWER, allows different partitions to make 
assignments to the same unit record device. Consequently, POWER/VS does not require 
that dummy (non-existent) devices be generated in the DOS/VS supervisor in order J 

to allow each partition to "pretend" that it has its own reader, printer, and punch. " 
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DUMMY PRINTERS AND PUNCHES 



With POWER/VS the dummy device concept still exists, but serves a different purpose. 
It allows each partition under its control to operate as if it had up to 8 printers and 
8 punches. This means, for example, that as many as 8 printer files can be created 
by one job step without the need to assign these files to intermediate tape or disk 
for printing by subsequent jobs. 

For a discussion of dummy printers and punches, refer to the LST and PUN parameters 
of the * $$ LST and * $$ PUN statements in "Job Entry Control Language" and to 
the PRINTERS and PUNCHES statements in "POWER/VS Start-Up". 



SUPPORTED HARDWARE DEVICES 



POWER/VS can execute in any model of System/370 that is supported by DOS/VS 
and has at least 96K of real storage. 

With the exception of those models not supported by DOS/VS, the following devices 
are supported: 



Readers 


Printers 


Punches 


Spooling Devices 


Terminals 


1442 


1403 


1442 


2400 Series 


2770 


2501 


1443 


2520 


3400 Series 


2780 


2520 


3203 


2540 


2314/2319 


3780 


2540 


3211 


2560 


3330/3333 




2560 


5203 


3525 


3340 




3504 




5425 






3505 










3525 










3540 










5425 











1. The IBM 2495 Tape Cartridge Reader cannot be used as a spooling device. 

2. The IBM 2400 and 3400 series magnetic tape units cannot be used to spool input 

3. The IBM 3540 Diskette Input/Output Unit is not supported by this component 
release of POWER/VS. 

4. 3505, 1442, 2520, 2560, 3525, and 5425 are treated as sequential files only 
(not as combined files). 

The card I/O functions supported by POWER/VS are indicated in the following table. 
Each row represents a valid combination of functions. 



DEVICE 


FUNCTION 


READ 


PUNCH 


STACKER SELECT 


INTERPRET 


PRINT 


1442 


X 


X 


X 






2501 


X 










2520 


X 


X 


X 






2540 


X 


X 


X 






2560 


X 


X 
X 


X 
X 
X 


X 


X 
X 


3504 


X 










3505 


X 










3525 


X 


X 
X 


X 
X 
X 


X 


X 
X 


3540 


X 










5425 


X 


X 
X 


X 
X 
X 


X 


X 
X 
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Printer Support 



3540 Support 



The following I/O devices are supported by RJE: 

IBM 545 Punch (Model 3 or 4) on the 2770 

IBM 2213 Printer (Model 1 or 2) on the 2770 

IBM 2502 Card Reader (Model Al or A2) on the 2770 

IBM 2203 Printer (Model Al or A2) on the 2770 

IBM 3781 Punch on the 3780 

Teleprocessing control units supported by RJE are: 

IBM 2701 Data Adapter Unit 

IBM 2703 Transmission Control Unit 

IBM 3704 Communications Controller in 2703 emulation mode 

IBM 3705 Communications Controller in 2703 emulation mode 

Integrated Communications 'Adapter for Models 115, 125, and 135 

Teleprocessing connections must be point-to-point on switched or non-switched (leased) 
lines. Multipoint connections are not supported. 



The Universal Character Set buffer (UCB) and forms control buffer (FCB) features are 
supported by POWER/ VS. The execution processor accepts UCB and FCB load requests 
from the various supported partitions for later action at list time. Upon encountering 
an FCB load command, the execution processor updates the internal buffer 
representation (line count table) to reflect the FCB to be used at print time. UCB 
and FCB specifications can be made either in the user program or in the POWER/VS 
LST or PRT cards. (See "Job Entry Control Language".) i 



Note. The following description of support for the IBM 3540 Diskette Input/Output 
Unit is provided for planning purposes only. Support is not included in this component 
release. It is planned for availability on March 1975. 

POWER/VS is able to combine input from a card reader and a 3540 into a single 
sequential input stream. It is also possible to read the entire job stream from a 3540 
file. Multivolume diskette files are supported. 

The size of the records read from SYSIN files is obtained from the HDR1 label on the 
file. Records must be 80 or 81 bytes. Only the first 80 bytes are copied to the data file. 
These records are scanned for control statements. The SYSIN records can be read only 
by a user program that SYSIN assigned to a card reader. Because DTFDU cannot be 
assigned to a card reader, DTFDU cannot be used to access these files. 

For data files, a read task reads records of any length between 1 to 128 characters. 
These records are not examined for control statements and are written on the spool 
file exactly as read. The data records cannot be read by programs accessing the SYSIN 
device. They can only be read by the programmer logical unit specified in the JECL 
RDR statement. This logical unit must be assigned to a 3540. 



< 
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POWER/VS GENERATION 



GENERATION MACROS 



POWER/VS generation involves: 

• Selection of macro options 

• Assembly of the macros to create the POWER/VS generation table 

If the generated version supplied by IBM is adequate, POWER/VS generation is not 
required. The supplied program is described later in this chapter. 

After generation, POWER/VS is initialized as described in "POWER/VS Start-Up". 



POWER/VS generation macros consist of the macro "POWER" and two RJE macros, 
"PLINE" and "PRMT". 



POWER Macro 



The POWER macro is the only required POWER/VS generation macro. 

The "name" field of the POWER macro becomes the phase name of the PHASE card 
(first card of the POWER/VS object deck), "name" is one to. eight alphameric characters. 
The name "POWER" is generated if a name is not specified. 

Name Operation Operands 

POWER DBLK=| — 11 * 

,TRACKGP=< — > * 

~LTAB= ( P M0 5 >10^,20,25,30,35,40,45,50,56) Y] * 

I Ud0,dl,d2,d3,d4,d5,d6,d7,d8,d9,dl0,dll,dl2)/J 

"PRI={^}] 
^ACCOUNT^II}] 

r (ro.oui * 



1 power] 
name J 



[sTDLINE={pir 
L I (n,m)J j 

*™— {£&}] 
MS 1 }] 

[rdrexit= <^->] 

11 (name j J 

YE1S 
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* 



3.1 



DBLK 



=B 



Specifies the block size (in bytes) of data file records and, consequently, the size of 
each data buffer. (Data buffers are used as I/O areas by execution processors, 
readers/writers, and RJE routines.) "n" must be an integer from 516 to 2008. 

If DBLK is omitted or set to and if a cold start is performed, the system assumes 
a block size appropriate to the device type used for the data file: 



Device Type 


Data Block Size 


2314/2319 
3330/3333 
3340 


920 
952 
808 



TRACKGP= 



■«} 



Note. The increased disk arm activity produced by DBLK specifications smaller than 
the default values might affect POWER/ VS performance. 



Specifies the number of tracks in a track group. A track group is the amount of disk 
space that is made available in the data file upon a request for space by a POWER/VS 
task, "n" can be any integer from 1 to the number of tracks on a cylinder of the 
device assigned to the data file. ^ 3$ DO =- l°\ faftK -^ &$- 7~^frz s /cv l. 

Track groups do not cross cylinder boundaries. Remaining tracks are added to the last 
track group on each cylinder. 

If the TRACKGP parameter is omitted or set equal to (or conflicts are detected 
at initialization time), and a cold start is performed, POWER/VS calculates a suitable 
track group size. When a warm start is performed, the track group size established at 
the previous cold start is used. 



LTAD _ 1 (10,00,05,10,15,20,25,30,35,40,45,50,56) ) 
I(d0,dl,d2,d3,d4,d5,d6,d7,d8,d9,dl0,dll,dl2)j 



PRI= 



ft 



Defines the system's standard forms control tape or forms control buffer for its printers. 
If LTAB is specified, all entries in the sublist (dO through dl2) must be present. Each 
entry is specified as two digits. 

LTAB specifies the distance (in number of print lines) from the first carriage control 
tape channel punch to the other channel punches, and to .the end of the page. dO 
specifies the distance from the channel 12 punch to the first punch; dl specifies the 
distance between the first punch and the channel 1 punch; d2 specifies the distance 
between the first punch and the channel 2 punch; and so on. If channel 1 is the first 
punch, the distance dl is expressed as 00. If a channel is not punched, 00 should be 
specified for that channel. An LTAB of all zeros can be specified to avoid a channel 12 
indication. 

If LTAB is not specified, the default is: 

(10,00,05,10,15,20,25,30,35,40,45,50,56) 

The default defines a 66 line carriage control tape (buffer), where the distance between 
channels 1 and 12 is 56 lines, the distance between channels 12 and 1 is 10 lines, 
the distance between channels 11 and 12 is 6 lines, and the distance between all other 
channels is 5 lines. 

Specifies the default priority (1-9) if priority is not specified in the * $$ JOB statement. 
Nine is the highest priority. 

If PRI is not specified, the default value is 3. (Priority is discussed in "POWER/VS 
Concepts and Facilities"). 



( 
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SUBLIB= 



-w 



Specifies the sublibrary of the source statement library to be searched when the 
sublibrary is not specified in the * $$ SLI statement. When an SLI statement is 
encountered in the job stream, POWER/VS searches the private source statement library 
(if one has been assigned in the POWER/VS partition) and the system source statement 
library for the requested book, and inserts it into the job stream. If NO is specified 
or if this operand is omitted, the SLI statement is not supported; it is treated as data. 

"s" may be A through Z, through 9, $, #, or @. (Note that sublibraries A, C, D, 
E, F, and Z already have special purposes in DOS/ VS.) 

If SUBLIB is omitted, NO is assumed, and sublibrary inclusion is not supported. 



ACCOUNT 



(YES/ 



Specifies whether or not POWER/VS is to maintain accounting information. If NO is 
specified, no information is maintained (apart from that provided in the status report; 
see "Appendix D"). If YES is specified, accounting information is gathered, merged with 
DOS/VS accounting information, and stored in the POWER/VS account file (IJAFILE). 

// DLBL and // EXTENT information for the POWER/VS account file must be provided 
when POWER/VS is initialized. The logical unit specified in the EXTENT card must 
be SYS000. Job accounting must be specified in the DOS/VS supervisor. 



STDLINE 



= i&0)) 
Kn,m)f 



M n" is an arbitrary limit on the number of lines that can be generated for a job entry 
before warning message 1Q52I is issued to the operator stating that the limit has been 
exceeded, "m" specifies the additional number of lines that can be generated before 
the same message is reissued. Both n and m can be up to 6 digits. 

A specification of means that no warning will be given. If one of the entries is omitted, 
the value provided is used for both entries. 

If STDLINE is omitted, (0,0) is assumed. 



STDCARD 



\(n,m)( 



"n" is an arbitrary limit on the number of card images that each job entry can generate 
before warning message 1Q52I is issued to the operator stating that the limit has been 
exceeded, "m" specifies the additional number of records that can be generated before 
the same message is reissued. Both n and m can be up to 6 digits. 

A specification of means that no warning will be given. If one of the entries is omitted, 
the value provided is used for both entries. If STDCARD is omitted, (0,0) is assumed. 



POWER/VS Generation 3.3 



™> ® 



Specifies whether POWER/VS is to display each job name together with the job number 
whenever an * $$ JOB statement is read. If YES is specified, all such statements are 
logged on the system console (SYSLOG) at execution time. If NO is specified, no such 
logging takes place. 



j SE p= m\ 

l(n,m)J 



Specifies the number of special pages or cards to be included in the output to separate 
job entries, "n" specifies the number of separator pages, "m" specifies the number 
of separator cards, "n" and "m" can be any digit from to 9. If either is omitted, 
is assumed. 



The information in the separator pages or cards pertains to the output that follows. 
A separator page is printed with 10 lines, each of which contains the POWER/VS job 
name and number, user information from the * $$ JOB card, and the date and time, 
separator cards contain only the job name. 

Note: Stacker selection is ignored for punch output with card separators. 



= j(2£) \ 
l(n,m)f 



Specifies the number of list pages (n) and/or the number of punch records (m) that 
can be processed before the output is segmented. This parameter is used only when 
spooling to disk intermediate storage, "n" and "m" can be from one to six digits. 
A specification of means that no segmentation will take place. If n or m is omitted, 
is assumed. 

Note. Skip to channel 1 delimits a page; that is, if there are no skips to channel 1, page 
count is not incremented. 



_ f NO \ Specifies whether a user-written POWER/VS read task exit is supported. Upon 
RDREXIT- Y narne J initialization of POWER/VS, the phase with the name specified in the RDREXIT 
parameter is loaded into the POWER/VS partition. See Appendix G. - RDREXIT 
Routines. 






~^ D " ^ 









-s' V- 



\]« 



r \ v.; • 



Xf~ 



( 
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PLINE Macro 



>G?l> 



The PLINE macro defines the hardware characteristics of an RJE line (the integrated 
communications adapter) or the transmission control unit at the central processor. One 
macro must be specified per line. Up to 25 RJE lines are supported by POWER/VS. 
However, with an integrated communications adapter (ICA) only four BSC lines are 
supported on a System/370 Model 115, only six BSC lines on a System/370 Model 
125, and only eight BSC lines on the System/370 Model 135. 

The POWER macro must precede the PLINE macro. 



PLINE 



ADDR=X'cuu' 



,TIMEOUT= 



I- 

( n 



NQJ' 

>SWRD=password " 
[TRNSP=|^j] 
mnF _ < EBCDIC 

: C0DE- ascii 



I] 



ADDR=X'cuu' 



Specifies the line address (channel and unit number) in hexadecimal. This is the same 
address used to identify the control unit to the DOS/VS supervisor. 

This parameter is required. 



TIMEOUT 



-V) 



Specifies the number of minutes a terminal is allowed to remain idle before SIGNOFF 
is forced, "n" may be any number from to 255. If NO is specified or this parameter 
is omitted, the terminal is allowed to remain idle with the line open until manually 
disconnected. 



PSWRD=password 



Specifies the security password that must be submitted by the remote operator to 
connect his terminal to the central system. The password can be up to 8 characters 
in length. It can be overridden (until the next PSTOP command) by the central operator 
via the PSTART command. If this parameter is omitted, no password orocessing will 
be done. 



™ SP =&1 



Specifies the transparency feature on the integrated communications adapter or the 
transmission control unit. This feature is needed to transmit object decks. 

NO can be specified only if no object decks are to be transmitted over the line and 
if all other data is transmitted in non-transparent mode. In non-transparent mode, all 
characters transmitted to the terminal that are between X'OO' and X'40' are converted 
to zeros. 



"HSS*} 



Specifies the transmission code, which can be either EBCDIC or ASCII. The six-bit 
transmission code is not supported. 
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PRMT Macro 



The PRMT macro defines the hardware characteristics of an RJE terminal, identifies 
the user, and describes where his output is to be routed. At least one PRMT macro 
must be supplied for each user. If any feature is specified for a terminal on which 
that feature is not supported, the parameter is ignored. 

All PRMT macros must be supplied after the PLINE macro(s), and must be specified 
in consecutive ascending sequence, starting with one, according to their remote-ids. 
(See the REMOTE parameter below.) 

Two formats of the PRMT macro can be used. The format that includes the REF 
parameter can be used to define a user of a terminal that has the same features as 
those described by a previous PRMT macro. 



PRMT 



REMOTE=nnn, 



TYPE= 




|,LSTROUT= {— -A] 

,PUNROUT=/^A] 
(remidj J 



£■ 



>TRNSP= {XES}] 



'■H&}] 

/120.V 

*1 /M / 



144 
J NO 



[• trace =0 

,cs=|- 

lYES 



M£}] 



or 



[ 



PRMT REMOTE=nnn, 

REF=mmm, 

[,TRACE={^}] 
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REMOTE=nnn 



Specifies the remote-id (which identifies the user of an RJE terminal) to which this 
PRMT macro applies, "nnn" can be any integer from 1 to 200. If REMOTE=l , reference 
must not be made to another macro (the REF parameter cannot be used). 

The remote-id defines a user rather than a terminal. Multiple users of the same terminal 
may have different remote-ids. This prevents output for one user to be mistakenly sent 
to another, and it allows for separate accounting. In a situation where, for example, 
two users of the same terminal have different remote-id's, two PRMT macros must 
be generated, but instead of specifying the terminal characteristics twice, the second 
macro may simply refer to the first (REF=mmm). The REF option can also be used 
when different terminals are used with identical hardware characteristics. 

Remote-id must be assigned and generated in consecutive ascending sequence. Reference 
can only be made to another macro with a smaller number. The first PRMT must not 
refer to another macro and must specify REMOTE=l. 



TYPE= 




Specifies the type of terminal, which may be a 2770, 2780, or 3780. 



LSTROUT=i mm . J i 
(remidj 



Specifies where the list output from jobs submitted by this remote-id is to be routed 
by default. If this parameter is omitted, the same nnn specified in the REMOTE 
parameter is assumed. 



PUNROUT= 



j nnn | Specifies where the punch output from jobs submitted by this remote-id is to be routed 
(remidf by default. If this parameter is omitted, the same nnn specified in the REMOTE 
parameter is assumed. 



TRNSP= 



{ YES ) Specifies the transparency feature on the terminal. This feature is required for the 

NO f transmission of object decks. 

If NO is specified, all characters between X'00' and X'40' are converted to zeros. YES 
is assumed if this parameter is omitted. 




f HQ ") Specifies buffer expansion, which applies to the 2770 only. If NO is specified, the 
X VE5s\ ® ZG °^ ^ e ^ u ^ er ^ 128 bytes. If YES is specified or if this parameter is omitted 
-* the size of the buffer is 256 bytes. 






Specifies additional buffer expansion for the 2770. The size of the buffer is then 512 
bytes. If NO is specified or if this parameter is omitted, buffer size is determined by 
the BE parameter. 

Specifies horizontal format control on the 2770, 2780 or 3780. 
Note. // HFC and SCE are both specified, HFC is ignored. 



Hlsl 



Specifies space compression/expansion, which applies to the 2770 and 3780 only. 



MRF= 



\ yes/ 



Specifies the multiple record feature for the 2780. 



LIST= 



120 

80 

132 

144 



Specifies the printer width (the number of print positions in a line). The numbers 80, 
120, 132 and 144 are valid entries. When this parameter is omitted, 120 is assumed. 



POWER/VS Generation 3.7 



TRACE= 



NO 
YES 



..4 %? t . . :v ''". Vv ■■' % ■ '* = v 



«,V ■ " ^ : y. >'.« 



* IK .'^ 



Specifies that all I/O interrupts are to be traced for this terminal as soon as this remote-id 
is signed on. 



CS- 



i NO 



J YES 
REF=mmm 



Specifies support for the component selection feature on the 3780. This is required 
for the 3781 punch. 



Specifies the remote-id of another PRMT macro that describes the terminal characteristics 
of this PRMT macro, "ramm" can be any integer lower than the nnn used in the 
REMOTE parameter, "mmm" can therefore be in the range 1 to 199. 



PRE-ASSEMBLED POWER/VS PROGRAM 



The pre-assembled (generated) POWER/VS program supplied by IBM specifies the 
following parameters: 



POWER POWER DBLK=0, 

TRACKGP=0, 

LTAB=(10,00,05,10,15,20,25,30,35,40,45,50,56), 

PRI=3, 

SUBLIB=NO, 

ACCOUNT=NO, 

STDLINE=(0,0), 

STDCARD=(0,0), 

JLOG=YES, 

JSEP=(0,0), 

RBS=(0,0), 
RDREXIT=NO 

Note. All of the above parameters have taken default values. 



POWER/VS FILE LABELS 



The following example job stream catalogs and then executes a procedure to create 
standard labels for POWER/VS files and DOS/VS system files that reside on two 3340 
disks. 

One extent is defined on the SYSRES pack for the queue file. It can contain 624 
152-byte queue records and thus can describe 618 track groups. 

The data file resides on two volumes. Its size is 103 cylinders, which is equivalent 
to 618 track groups, 2 tracks per track group. 

There is also a standard label shown for the POWER/VS account file. If the account 
file is to be emptied and copied to a user disk file by a PACCOUNT command, standard 
labels for this user file can also be included. 



( 
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// JOB CATALOG a STDLABEL' PROCEDURE FOR 3340 POWER/VS 
// EXEC MAINT 

CAT ALP STDLABEL 

* STANDARD LABELS FOR 3340 'POWER/VS' SYSTEM, 09/30/74 
// OPTION STDLABEL 

// DLBL IJSYSRS,»DOS/VS+POWER/VS. SYSRES. FILE', 99/365, SD 

// EXTENT SYSRES, SYSRES, 1,0, 1,7199 600 CYLS, - 599, ON SYSRES 

// OLBL IJSYSCN, 'DOS/VS. HARDCOPY. FILE', 99/365, SD 

// EXTENT SYSREC, SYSRES, 1,0,7200,60 5 CYLS, 

* EXTENT SYSVlS.SYSRES, 1,1,7260,168 14 CYLS, 

* POWER/VS AUTOSTART FILES, 7448, 12 1 CYL , 
// DLBL IJQFILE, 'POWER/VS. QUEUE. FILE • ,99/365, DA 
// EXTENT SYS001,, 1,0,7440,24 2 CYLS, 
// DLBL IJOFILE, 'POWER/VS. DATA. FILE', 99/365, DA 
// EXTENT SYS002,, 1,0, 7464, 804 67 CYLS, 
// EXTENT SYS003,, 1,1,3480,432 36 CYLS, 290 
// DLBL IJAFILE, 'POWER/VS. ACCOUNTING. FILE ',99/365, DA 
// EXTENT SYSOOO,, 1,0,8268,60 5 CYLS, 
// DLBL IJSYSRC'DOS/VS. RECORDER. FILE', 99/365, SD 
// EXTENT SYSREC, SYSRES, 1,0,8328, 12 1 CYL , 

* EXTENT VTOC 1 CYL , 
// DLBL IJSYSLN,'DOS/VS.SYSLNK.FILE',0,SD 
// EXTENT SYSLNK,,1,0,12, 108 9 CYLS, 
// DLBL IJSYS01,'D0S/VS. WORK-FILE. l',0,SD 
// EXTENT SYS001, ,8,0, 120, 1000,3 1/3 SPLIT 
// DLBL IJSYS02,'D0S/VS. WORK-FILE. 2', 0,SD 
// EXTENT SYS002,, 8,0, 124,1000,7 1/3 SPLIT 
// DLBL IJSYS03,'D0S/VS. WORK-FILE. 3', 0, SD 
// EXTENT SYS003,,8,0,128,1000,11 1/3 SPLIT 
// DLBL IJSYS04,'D0S/VS. WORK-FILE. 4', 0,SD 
// EXTENT SYS004,, 1,0, 3120, 360 30 CYLS, 

* DOS/VS 3340 STANDARD LABELS CREATED * 
/* 
/ + 
/* 

// EXEC PROC=STDLABEL 
/£ 
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SYSRES 
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SYSRES 
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- 619, 
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SYSRES 
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- 621, 
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689 


- 693, 


ANY 
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694 


- 694, 
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SYSRES 


695 


- 695, 
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SYSRES 
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9, 


ANY 


DRIVE 
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- 259, 


ANY 


DRIVE 


10 


- 259, 


ANY 


DRIVE 


10 


- 259, 


ANY 


DRIVE 


260 


- 289, 


ANY 


DRIVE 



DOS/VS SUPERVISOR GENERATION REQUIREMENTS 



POWER/VS requires a DOS/VS supervisor generated with POWER=YES in the SUPVR 
macro. This generation option forces the additional options PHO=YES, PFIX=YES, 
ECPREAL=YES, and NPARTS=3. (NPARTS specifications 2, 4, and 5 are also valid.) 

If POWER/VS accounting support is required, job accounting must also be generated in 
the supervisor. 

Since RJE uses its own teleprocessing access method, it does not require any telepro- 
cessing support to be generated in the supervisor. 

Both the ALLOC and the ALLOCR macro are used to define the POWER/VS partition. 
Refer to "Storage Requirements" to determine the appropriate real and virtual storage 
sizes. 

If dummy printers and punches are to be supported, they should be generated, using the 
DVCGEN macro. 

The number of LUB entries for programmer logical units in the POWER/VS partition 
must be large enough to accommodate all read and write tasks that may be running 
concurrently. If the number of programmer logical units in the POWER/VS partition 
is insufficient, (i.e., too many tasks are started concurrently) a message is issued. 
Programmer logical units SYSOOO through SYS006 are reserved for POWER/VS files. 
The logical units used for POWER/VS files must be assigned by "the user. The other 
logical units are automatically assigned and unassigned during POWER/VS execution. 

Typically, at least 10 LUB entries are required: 7 for POWER/VS disk files and 3 for 
the read, list, and punch tasks. Additional LUB entries are needed for RJE tasks: one 
entry per task, per line. LUB entries are also required for tape files used to either 
spool output or save the contents of the account file. 
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MAIN STORAGE REQUIREMENTS 



Both a virtual partition and a corresponding real partition must be allocated for 
POWER/VS. 

The virtual partition contains the permanent area, fixable area, and pageable area. 

• Permanent Area. Consists of three pages (6K) that are fixed at POWER/VS 
initialization and remain fixed until POWER/VS is terminated. These pages contain 
the POWER/VS nucleus and control tables, which do not tolerate paging activity. 

• Fixable Area. Consists of those pages that are fixed when a task is started and 
freed when the task becomes inoperative. The size of the fixable area determines 
the number of data buffers available to the system and hence the number of 
POWER/VS tasks that can execute concurrently. Besides data buffers, this area 
contains dynamic control blocks. 

Page fixing and freeing is controlled by the storage management service of 
POWER/VS. Free pages within the fixable area form part of the DOS/VS page 
pool and are therefore available for use by other partitions. 

• Pageable Area. Consists of pages that can be freed when other partitions require 
additional real storage. These pages contain the major part of the POWER/VS code, 
which is re-entrant and therefore never needs to be paged out (saved). The virtual 
address space required by this area is 128K. 

All of the permanent area resides in the real partition space allocated to the POWER/VS 
partition by the ALLOCR statement. The fixable area is the remainder of the real storage 
allocated. The permanent and fixable areas together cannot exceed 128K. An ALLOCR 
greater than 128K, however, is valid. 

If a user RDREXJT routine is to be used, add its size to the virtual address space require- 
ment for the POWER/VS partition; that is, increase the pageable area size beyond 128K. 
See Figure 6. 

Pages within the fixable area are PFIXED and PFREED as required throughout 
POWER/VS execution. A request for storage is satisfied immediately if space is available 
in the fixable area. If not available, a message is issued and the task waits until storage is 
freed. 

Use the following table to determine the maximum" real storage requirement for the 
permanent and fixable areas. 



Task or Line 


Real Storage (bytes) 


Permanent area 


6144 


Dynamic control blocks 


2048 


Each read/write task (one for each 
active unit record device) 


1024 + N 


Each execution read task (one for 
each active card reader, real or 
dummy, referenced in a POWER/VS 
controlled partition) 


488 + N + X 


Each execution write task (one for 
each active printer/punch, real or 
dummy, referenced in a POWER/VS 
controlled partition) 


488 + N 


Each inactive RJE line 


288 


Each active RJE line 


768 + P + N 



( 
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Where: 



N = 32*n 



n = 



DBLK + 39 

32 



DBLK represents the value specified in the DBLK parameter of the POWER macro. 
DBLK can vary from 516 to 2008. 

P = the terminal buffer size (128, 256, or 512). 

X=0 if the SLI facility is not used by the execution read task. X= 288 when the SLI 

facility is used by an execution read task. 

To determine the total virtual address space required by the POWER/VS partition 
(ALLOC), add the real storage requirement to the 128K required by the pageable area. 



ALLOC Size 
(Virtual address 
space allocation) 



128K 



ALLOCR Size 
(Real storage allocation 
for page fixing) 



Pageable Area 



Fixable Area 



Permanent Area 



Optional User RDREXIT Phase 

Optional POWER/VS Phases for 
SLI, RJE, Accounting Support 



V POWER/VS Code 



► I/O Areas, Control Blocks 



POWER/VS Nucleus, Control Tables 



Figure 6. POWER/VS Partition Layout 
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Examples: 

In each of the following examples, ALLOC and ALLOCR are calculated for the 
POWER/VS partition (assumed to be Fl). 

Entry System Example 

• 1 card reader, 1 card punch, 1 printer. Cards are only punched occasionally 
(2 read/write tasks). 

• 1 controlled partition, referencing a reader, printer, and punch (3 execution 
processors). 

• Minimum DBLK of 516 bytes, to reduce POWER/VS real storage requirement. 

• SLI facility. 

Permanent area 6144 

Dynamic control blocks 2048 

Read/write tasks 2*(1024 + 32*17) = 3136 

Execution read tasks 1 *(448 +32*17+ 288) = 1 280 

Execution' write tasks 2*(448+ 32*17) = 1984 

14592 bytes 

Hence, the following allocations would be required to run POWER/VS in Fl: 

ALLOCR F1R=16K 

ALLOC F1=144K (128K+16K) 

Typical System Example 

• 1 card reader, 1 card punch, 1 printer (3 read/write tasks). 

• 2 controlled partitions. Normally, one partition references 1 reader and 2 printers, 
the other a reader, printer, and punch (6 execution processors). 

• DBLK default value of 808 bytes for 3340 disk. 

• SLI facility used in both partitions. 



Permanent area 




6144 


Dynamic control blocks 




2048 


Read/write tasks 


3*(1024+ 32*26) 


5568 


Execution read tasks 


2*(448+ 32*26 + 288) = 


3136 


Execution write tasks 


4*(448+ 32*26) 


5120 
22016 bytes 


Hence: ALLOCR F1R=22K 






ALLOC F1=150K 







Large System Example 

• 2 card readers, 1 card punch, 3 printers (6 read/write tasks). 

• 8 RJE lines. Normally 5 active. 

• 4 controlled partitions. Normally: 

— One partition references 1 reader and 1 printer. 

— Two partitions each reference 1 reader, 1 punch, and 1 printer. 

— One partition references 1 reader, 1 punch, and 4 printers. 
(Total of 4 execution read tasks and 10 execution write tasks.) 

• DBLK maximum of 2008 bytes for best POWER/VS performance. 

• Terminal buffer size of 256 bytes. 
SLI facility used in all 4 partitions. ■ 



• 4K RDREXIT routine included. 
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Permanent area 




6144 


Dynamic control blocks 




2048 


Read/write tasks 


6*(1 024 +32*63) 


18240 


Execution read tasks 


4*(448+ 32*63+ 288) = 


11008 


Execution write tasks 


10*(448+ 32*63) 


24640 


Inactive RJE lines 


3*288 


864 


Active RJE lines 


5*(768+ 256 + 32*63) = 


15200 


User RDREXIT routine 




4096 
82240 bytes 


Hence: ALLOCR F1R=82K 






ALLOC F1=210K 







An ALLOCR value larger than calculated can be specified. This would create a larger 
fixable area and thus might increase paging activity in the system. 
An ALLOCR value smaller than calculated can be specified. This would reduce the size 
of the fixable area. As a result, POWER/ VS tasks may occasionally have to wait for real 
storage space to be freed. 



DIRECT ACCESS STORAGE REQUIREMENTS 
DOS/VS System Libraries 



POWER/VS Files 



Data File 



Queue File 



POWER/VS is distributed as source macros and core-image phases, including a version of 
POWER/VS that was generated using the default values of the POWER macro parameters. 
(Refer to 'Pre-assembled POWER/VS Program'.) 



The POWER/VS data file can occupy up to five extents of direct access storage. The 
queue file and account file occupy one extent each. 

The following information will assist in establishing preliminary POWER/VS file sizes. 



For the data file extents, estimate separately the total number of input/output card 
images and the total number of line images spooled to disk in a typical 8 hour shift. 
Choose a file size large enough to hold half this amount of data. This should prevent 
POWER/VS from running out of file space. File extents can be respecified if they later 
prove to be too large or too small. 

The size of the DBLK parameter in the POWER macro determines how many records 
will fit into a data block and how many data blocks will fit on a track. Also note that 
POWER/VS omits trailing blanks from all records placed on the data file. 

To quickly determine a reasonable data file size, use one of the following as a guideline. 

• 2314 100 cylinders hold 90,000 line images or 1 35,00 card images 

• 3330 100 cylinders hold 160,00 line images or 240,000 card images 

• 3340 100 cylinders hold 60,000 line images or 90,000 card images 



The queue file should be large enough to support the entire data file; that is, there should 
be one queue record for each track group in the data file. 

The number of track groups depends on the size of the data file and on the number of 
tracks per track group (specified in the TRACKGP parameter of the POWER macro). 
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Account File 



If the minimum TRACKGP value of 1 is used, then one queue record is needed for each 
track of the data file. This increases queue management overhead and disk activity, but 
best utilizes the disk space available in the data file. Conversely, if the track group size is 
large, queue management overhead is reduced, and because only one job entry can use a 
track group, disk space is wasted whenever that entry does not fill a track group. A track 
group of 2 is often a good compromise. 

The following table shows queue records per track/cylinder for each disk type. 



Device 


Queue Records 
per Track 


Tracks per 
Cylinder 


Queue Records 
per Cylinder 


2314 
3330 
3340 


28 
45 
26 


20 
19 
12 


560 
855 
312 



Note. Up to 6 queue records are reserved for POWER/VS internal use. The remainder 
of the records in the file are used to describe track groups. 

If a track group size is not specified explicitly, POWER/VS, at initialization, calculates 
the number of tracks within the extents provided by the data file, and determines the 
number of 152-byte records it can write within the queue file. From these two figures it 
determines the smallest track group size that allows all of the data file to be used. 
Moreover, if the user-specified track group is too small and the entire data file cannot 
be used, POWER/VS changes the track group value and informs the operator. If there 
are more cylinders of data file than there are queue records, the extra data file space is 
not used. 

The queue file extents in the example under 'POWER/VS File Labels' define two cylin- 
ders of 3340 disk. This equates to 624 queue records, which can describe 618 (i.e., 
624-6) track groups. This, in turn, allows for 51 cylinders of 3340 data file space if 
TRACKGP=1, 103 cylinders if TRACKGP=2, 154 cylinders if TRACKGP=3, etc. 



The following list shows approximately how many DOS/VS jobs can be handled by 
one cylinder of the account file. 

• 2314 110 jobs 

• 3330 170 jobs 

• 3340 60 jobs 

These estimates are based on an average of 5 account records per job. 

When the account file becomes 80% full, a warning message is issued. The file should then 
be saved or deleted using the PACCOUNT command. 

Note. If any POWER/VS file fills completely, the operator is notified, and any task 
requiring space in the file waits until space becomes available. 



( 



( 
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POWER/VS START-UP 



Start-up of POWER/VS can be done exclusively through the operator console, or in many 
cases, the procedure can be simplified for the operator by using the AUTOSTART 
facility, which allows most of the commands and specifications to be entered in the form 
of card images. Examples of both approaches to POWER/VS start-up follow. 

'Start-Up Considerations', at the end of this section, contains information which can 
help to determine which approach is better for a particular environment. 



START-UP, WITHOUT AUTOSTART 



The following steps whose numbers are suffixed by 'A' relate to the sample console 
log, Figure 7. In the example, the POWER/VS partition is Fl, and BG is the only con- 
trolled partition. 

Note. Before starting POWER/VS, be certain that all devices to be spooled (dummy as 
well as real) are defined in the DOS/VS supervisor. 

1 Mount the disk pack(s) used for the POWER/VS files on the disk drive(s) and 
ready them. 

2A Make the reader, printer, and punch available for POWER/VS use by wwassigning 
these devices in the partition that 'owns' them. 

3A Stop BG. 

4A Start the POWER/VS partition (Fl). 

5 A If the current ALLOCR and/or ALLOC are not suitable, allocate sufficient real and 
virtual storage to the partition in which POWER/VS will execute. Refer to 'Storage 
Requirements' in 'POWER/VS Generation' to estimate the required real partition 
size. A value of 22K should be adequate for most systems. The required virtual 
size must be at least as large as the sum of 128K and the real partition size. 

6 Optionally assign SYSRDR to the Unit-record device from which job control state- 
ments will be read to initialize POWER/VS. If SYSRDR is not assigned in the 
POWER/VS partition, all job control statements in the following steps must be 
entered via SYSLOG. 

Assign SYSIPT (or SYSIN) if the AUTOSTART facility is to be used. See 
'AUTOSTART' in this chapter. 

Neither SYSRDR nor SYSIPT is assigned in this example. 

7 A If required, assign SYSLST so that: 

The POWER/VS status report plus a list of all entries in the POWER/VS 
queue is printed after a warm start. See Appendix D. 

A dump of the POWER/VS partition will occur if POWER/VS abnormally 
terminates during initialization (step 13 A). 

Not assigning SYSLST allows start-up and operation of POWER/VS without an 
available printer (i.e., there is no printer attached, printer is 'down', or printer is 
assigned to a non-spooled partition). 

8A Enter a DOS/VS JOB statement, which properly begins the new job and identifies 
the POWER/VS partition on the console log. 

9A Assign SYS000 to disk. If this logical unit is not assigned, account file logging is 
ignored, even if the DOS/VS supervisor and POWER/VS have accounting support. 
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5t 



1? ^ 



;::; r , A— ^ f 

BG * POWER/VS START-UP ENTIRELY FROM CONSOLE * 

, , D A- ' b g * 

) \ / ^ ( BG ASSGN SYSLST, UA 



t i 4 



^-^ ( BG ASSGN SYSLST, UA 

<^H It aIIgn IyIiTua* 7v> A M¥>^ - vE ^ f - K1&4L 

\ * ? G ?™ SYSIN, UA_ J2>& ^ ^ ' j^j b ^^^ r 



O ^Z :i <#& (!^vT !S^Xt B , r^ftu** '-" l T^R3 ( %5St 






AR START Fl 




^ \ ^J T (S^l " —- R ^ R 7?^.F2R=OK,BGR=22K ^^ 



Fl ALLOC Fl=150^_ M ^p 

Fl ASSGN SYSLST, PRINTER 

Fl 1T20I SYSLST HAS BEEN ASSIGNEO TO X»OOE« 
8 a) » Fl // JOB POWER/VS 

Fl // JOB POWER/VS 
,V k>- ^ DATE 08/06/74, CLOCK ,00/14/40 

Fl ASSGN SYSOOO, SYSRES 

Fl 1T20I SYSOOO HAS BEEN ASSIGNED TO X»I60» 
10A) ► Fl ASSGN SYS001, SYSRES 

Fl 1T20I SYS001 HAS BEEN ASSIGNED TO X»160» 

Fl ASSGN SYS002,SYSRES 

Fl 1T20I SYS002 HAS BEEN ASSIGNED TO X»160« 

^^ JLl~4^2^J_J5Y£GjQA--W*5 ^^ BEEN™ASSl4N,ED^I0^ x^t*r^~~~ 

p/A l U3A>— *■ Fl EXEC POWERVS 

-*tfe*/ Fl IQliO FORMAT QUEUES=Q,D,A 
~f "* ' ^ D v^ r ^ / *F1 4733 A EQUAL FILE ID IN VTOC IJQFILE 
"^ j^f ^ rN C^ I SYS001=160 SYSRES 

POWER/VS. QUEUE. FILE 



0- v ' 



<&{ 



^.a O t ^-' " ..iff I Fl DELETE 

Si. ., ?^ v 

jf 7 ?, 5i?P ? '^ ,&■ n) TT^ /-^ I POWER/VS. OATA. FILE 



A^^^AA" oV^ l* F1 4733A EQUAL FILE ID IN VTOC IJDFILE 

::"j^ ^ » \ SYS002=160 SYSRES 



&^ ' £$'•> " J) A ^(i4aW( Fl DELETE 
D o e " 5 -r^ ->" A ^- / l* F1 4733A EQUAL FILE ID IN VTOC IJDFILE 

_,tin' e^ I SYS003=161 111111 

-> A" v<sA / POWER/VS. DATA. FILE 

|\ \ £A I Fl DELETE 

Y)A & I *F1 4733A EQUAL FILE ID IN VTOC IJAFILE 

v ■ SYS000=160 SYSRES 

POWER/VS. ACCOUNTING. FILE 
Fl DELETE 
Fl 1Q12I POWER/VS INITIALIZATION COMPLETED 



p&vP 



^ I AR PSTART RDR.OOC 

E^Aj^lS / *F1 0P08A INTERV REQ SYS069=00C 



©H 



T CUVt r ^ \ AR PSTART PUN»OOD,AXP 

Fl 1Q34I PUN WAITING FOR WORK ON OOD 
AR PSTART LST, OOE 

Fl 1Q34I LST WAITING FOR WORK ON OOE 
AR PSTART LSTt04E,HBCA 
Fl 1Q34I LST WAITING FOR WORK ON 04E 
AR PSTART BG,OABI 
*F1 1R86D PLEASE SPECIFY DEVICES TO BE SPOOLED 
/f _ ( Fl 1R50D BG READER*OOC 



° (l6AW| Fl 1R50D BG PRINTERS=00E,01E,02E 

ftp K W' ( Fl 1R50D BG PUNCHES*00D,04D 

, Jfs ^ I BG ASSGN SYSLST, PRINTER 

_ M J ^ I BG 1T201 SYSLST HAS BEEN ASSIGNED TO X»00E» 

VDF v (T7AWf bg assgn syspch, punch 

T \-S I BG 1T20I SYSPCH HAS BEEN ASSIGNED TO X , 04D I 

<JY\ J r h A I BG "SSGN SYSIN, READER 

'0 -r S[>^M BG 1T201 SYSIN HAS BEEN ASSIGNED T0 x, ooc» 



rY^ 



BG 

Fl 1Q34I BG WAITING FOR WORK 



<$2* F1 1R48 j PUN,00D,AXP 

<^ c : ':' ~r&^ Fl 1R48I LST, OOE, A 



^ ^,^'> J ^o^ 1 Fl 1R48I BG,OOC,OABI '^ — '- — *-. T"' / 

\J>^* V«^ ' Fl 1R48I RDR.OOC.A - ^ 0^ ^ | 



, c-- r T ^^ Fl 1R48I LST, OOE, A tMlft{0(! 

C .U_^a Fl 1R48I LST,04E,HBCA k ^1-^^°^^ 



\S ^^^^^ Figure 7. Console Log for POWER/VS Start-up 
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f£vrt> 



10A Assign SYSOOl to disk for the POWER/VS queue file. 

11 A Assign SYS002 to disk for the POWER/VS data file. If the data file is to consist of 
multiple extents, SYS003 to SYS006 can also be assigned. 

12 Provide DLBL and EXTENT information for the POWER/VS disk files specified 
above. This can be done in one of four ways: as part of the job stream, within a 
start-up procedure, in the POWER/VS partition standard labels, or in standard 
labels (see 'POWER/VS file Labels' in 'POWER/VS Generation'). 

13A To initialize POWER/VS, specify the name of the default or user-created 
POWER/VS generation table in an EXEC statement. 



*?1 



rf)Y 14A With initialization, all required direct access files are opened. In addition, the 

fi " '" 



->' prompting message 1Q11D FORMAT QUEUES= is issued, which allows direct 






r,>V 



access files to be formatted. Possible replies to the message are: 
B k No or (END/ENTER) - No formatting (warm start) 

<2 Q% 'x ^ ~ Format account file 

^ l4 O : *- ^'^ - Format queue file (and account file) 

t>\^ / e>\ ^ >k ^ D(,A) - Format queue and data files (and account 

\ Y c ^W^' file) 

^.v 1 - e> ^ o G ' 

/*<e -*a„ u Note: Wiew tfie data file is specified, the queue file is also formatted. 

€?- 

Reformatting an existing file causes message 4733A to be logged. The operator 
V' ,v should then delete the existing file. If the operator decides not to format the files, 

^ he can cancel POWER/VS by pressing ENTER or keying CANCEL. 

■f 1 5 A Start POWER/VS tasks and user partitions. Commands must be entered through 

the console if SYSIPT was not previously assigned. If SYSIPT was assigned during 
initialization, the POWER/VS AUTOSTART facility can be used to initiate tasks 
and partitions. Commands can be entered in any order and at any time. 

Any number of partitions can be started. They must be inactive DOS/VS parti- 
tions with lower priority than the POWER/VS partition. 

16A For each partition started under POWER/VS, specify the reader, printer, and punch 
device addresses to be spooled. If a partition is started with an operator command, 
these addresses are provided as replies to prompting questions on SYSLOG. They 
are provided as parameters in READER, PRINTERS, and PUNCHES cards if the 
AUTOSTART facility is used. 

17A After starting a partition under control of POWER/VS; assign SYSIN, SYSLST, and 
SYSPCH for that partition. 



0/1/ \/R pKOC = ?CAP£fc.VS3L 



START-UP, WITH AUTOSTART 



AUTOSTART allows any number of POWER/VS PSTART commands and the addresses 
of spooled unit-record devices to be prepared on cards (or on tape of disk) and sub- 
mitted as batch data to POWER/VS at start-up. This simplifies start-up by reducing 
operator involvement. 

AUTOSTART is particularly suited to the frequent or regular initiation of a POWER/VS 
environment where the device addresses, tasks, spooled partitions, and RJE lines remain 
the same. 
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TO 


X»160» 


TO 


X'lbO* 


TO 


X«160« 


TO 


X'161» 



BG * POWER/VS START-UP DECK 

*BG 1C10A PLEASE ASSIGN SYSROR. 

BG STOP 

4B)-i=£ — *- AR START Fl 

^-^ ( Fl ASSGN SYSIN, READER 

(6BV-»-< Fl 1T20I SYSIN HAS BEEN ASSIGNED TO X»OOC» 

Fl ALLOCR F1R=22K,F2R=0K,BGR=20K 

Fl ALLOC F1=150K 

Fl 1T20I SYSLST HAS BEEN ASSIGNED TO X«00£» 

Fl // JOB POWER/VS 

DATE 08/06/74, CLOCK 00/29/34 

Fl 1T20I SYSOOO HAS BEEN ASSIGNED 

Fl 1T20I SYS001 HAS BEEN ASSIGNED 

Fl 1T20I SYS002 HAS BEEN ASSIGNED 

Fl 1T20I SYS003 HAS BEEN ASSIGNED 

Fl 1Q20I AUTOSTART IN PROGRESS 

Fl 1R75I F2 AUTOSTARTED 

Fl 1Q34I LST WAITING FOR WORK ON OOE 

Fl 1R75I BG AUTOSTARTED 

Fl 1Q34I LST WAITING FOR WORK GN 04E 

BG ASSGN SYSIN, SYSRES 

Fl 1Q12I POWER/VS INITIALIZATION COMPLETED 

F2 ASSGN SYSIN, SYSRES 

Fl 1Q34I PUN WAITING FOR WORK ON 000 

/C\ . / BG 1T20I SYSIN HAS BEEN ASSIGNED TO X»160» 

\Zy~*\ *F1 1Q35A EOF ON OOC 

BG 

F2 1T20I SYSIN HAS BEEN ASSIGNED TO X»160 t 

BG 1T20I SYSLST HAS BEEN ASSIGNED TO X»OOE» 

F2 

BG 1T20I SYSPCH HAS BEEN ASSIGNED TO X»04D» 

F2 1T20I SYSLST HAS BEEN ASSIGNED TO X»OOE» 

Figure 8. Console Log for POWER/VS AUTOSTART 






0-< 



* POWER/VS START-UP DECK * 

ASSGN SYSPCH, UA 

ASSGN SYSLST, UA 

ASSGN SYSIN.UA 

ALLOCR F1R=22K,F2R=0K,BGR=20K 

ALLOC F1=150K 

ASSGN SYSLST, PRINTER 
// JOB POWER/VS 

ASSGN SYSOOO, SYSRES POWER/VS ACCOUNTING FILE 

ASSGN SYS001, SYSRES POWER/VS QUEUE FILE 

ASSGN SYS002, SYSRES POWER/VS DATA FILE 

ASSGN SYS003,DISK,V0L=111111,SHR OPTIONAL 2ND EXTENT TO DATA FILE 
// EXEC POWERVS 
FORMAT=NO 
PSTART RDR.COC 
PSTART LST, OOE 
PSTART LST, 04E,HBCA 
PSTART PUN,0OD,AXP 
PSTART F2.H2CA 
READER=O0C 

PRINT ERS=OOE,0 IE, 02E 
PUNCHES=00D,040 
PSTART BG.OAEI 
READER=OOC 

PRINTERS=OOE,OIE,02E 
PUNCHES=00D,04D 

\ 



Figure 9. POWERVS AUTOSTART Deck 
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PROCEDURE 



The following steps whose numbers are suffixed by 'B' relate to the sample console log, 
Figure 8, and those steps suffixed by 'C relate to the sample card listing, Figure 9. In 
the example, the POWER/VS partition is Fl, and BG and F2 are the controlled partitions. 

Note. Before starting POWER/VS, be certain that all devices to be spooled (dummy as 
well as real) are defined in the DOS/VS supervisor. 

1 Mount the disk pack(s) used for the POWER/VS files on the disk drive(s) and 
ready them. 

2C Make the reader, printer, and punch available for POWER/VS use by t/nassigning 
these devices in the partition that 'owns' them. 

3B Stop BG. 

4B Start the POWER/VS partition (Fl). 

5C If the current ALLOCR and/or ALLOC are not suitable, allocate sufficient real and 
virtual storage to the partition in which POWER/VS will execute. Refer to 'Storage 
Requirements' in 'POWER/VS Generation' to estimate the required real partition 
size. A value of 22K should be adequate for most systems. The required virtual 
size must be at least as large as the sum of 128K and the real partition size. 

6B Assign SYSIN (SYSRDR plus SYSIPT) to a card reader, to tape, or to sequential 
disk. 

After assigning SYSIN, press END (ENTER on the System/370 Models 115 and 
125) to begin reading from SYSRDR. 

7C Job control statements as described in steps 7A-16A are then read, and POWER/VS 
is loaded. 

POWER/VS reads from SYSIPT until it finds a /* statement. All cards between the 
EXEC statement and /* must be valid AUTOSTART commands; that is, a 
FORMAT statement, PSTART commands, and address specification statements. 
All these commands must start in column one. 

At this point SYSRDR, SYSPCH, and SYSLST have been assigned in the 
POWER/VS partition, and tasks and partitions specified in PSTART commands 
have been started. 

User job streams to be read by POWER/VS can be placed immediately after the 
/* in the AUTOSTART deck. These jobs are automatically read after POWER/VS 
is initiated. 

Note. RJE lines can be started through AUTOSTART. 

8B Job control in each partition started gives the operator control through SYSLOG. 
This provides the opportunity to make or change assignments, execute procedures, 
or enter job streams. 

For each partition, press END (or ENTER) when all job control commands, if any, 
have been entered. 
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FORMAT Statement 



FORMAT is normally the first statement of the AUTOSTART deck. It is used to format 
POWER/VS files. 

!NO J - No formatting (warm start). 

A J - Format account file. 

D^A"]! - Format data and queue files (and account file). 

Q [,AJI - Format queue file (and account file). 

If FORMAT is not the first statement encountered, or is invalid, the operator is prompted 
with the following message: 

1Q11D FORMAT QUEUES= 

The following are valid replies: 

NO or END/ENTER 

A 

DQA] 

QM 

Note. When the data file is specified, the queue file is also formatted. 



Address Specification Statements 



For each partition started, the input/output device addresses to be intercepted and 
spooled by POWER/VS must be specified by the following address specification state- 
ments. These statements must appear in the order shown here: 



/NO I 
READE Hu7a"ddr| 

PRINTERS='— 



) 



\uraddr,uraddr2 ... uraddr8 

PUNCHES=|~ JJ ■„ ■ \ 

(uraddr,uraddrz ... uraddr8J 

uraddr. Address of the unit-record device whose input/output is to be spooled. 

uraddr2, ... uraddr8. Address(es) of additional printers or punches to be spooled. 

NO. Specifies no spooling. READER=NO provides writer-only support for a partition. 
Specifying NO for both PRINTERS and PUNCHES defines a reader-only partition. NO 
cannot be specified for all three. 

If there are errors in address specification statements or if any are missing, the operator 
is prompted with the following messages: 

1R86D PLEASE SPECIFY DEVICES TO BE SPOOLED 
1R50D READER= 
1R50D PRINTERS= 
1R50D PUNCHES= 



4.6 DOS/VS POWER/VS Installation and Operations 



START-UP CONSIDERATIONS 



POWER/VS can run in any partition, including BG, and can support all partitions with 
a lower dispatching priority. Although start-up is simpler when POWER/VS runs in BG, 
there are the following restrictions: 

• Certain DOS/VS system maintenance functions (MAINT) only execute in BG. 

• CE on-line diagnostic programs such as OLTEP must run in BG. If POWER/VS 
were run in a foreground partition, CE diagnostics could run concurrently. 

Once it is established which partition POWER/VS will execute in and what the required 
real partition size must be, start-up and system operation can be simplified by including 
standard defaults in the supervisor, using the following macros: 

ALLOC - POWER/VS virtual partition size. 

ALLOCR - POWER/VS real partition size. 

PRTY - POWER/VS partition priority, and priorities for spooled 

partitions. 

DVCGEN - Spool device specifications. One for each device including 
dummy printers/punches. 

ASSGN - POWER/VS logical unit assignments for account, queue, 

and data file. 
- SYSRDR/IPT/PCH/LST assignments in each POWER/VS 
supported partition or SYSRDR assignments to disk for 
each foreground partition. 

SYS000, SYS001, and SYS002 can be assigned to different device types. However, 
SYS003 through SYS006 must be assigned to the same device type as SYS002. 

Unit-record assignments for POWER/VS supported partitions can be made in the super- 
visor to simplify start-up and eliminate the need to enter partition-dependent statements. 

One approach is to use separate dummy device addresses for each partition. This, 
however, can create problems when a partition is started without POWER/VS. An 
alternative is to assign SYSRDR in each POWER/VS supported partition to a disk 
extent containing appropriate DOS/VS JCL assignments. This allows several partitions 
to be pre-assigned in the supervisor, minimizes the requirement for dummy devices, 
reduces operator input, and allows the user to create or change partition-dependent 
start-up job streams without altering the supervisor. The program and job stream to 
create such files are shown in "Appendix I". 

The DOS/VS PRTY operator command can be executed at any time, as long as it does 
not cause POWER/VS to have lower priority than any of its supported partitions. 

The set of classes handled by a partition can be changed by stopping the partition and 
then starting it again with a different set of classes. Also, the same classes could be 
specified in a different order of priority. 



Special consideration should be given to interactive data communications systems: 

• If POWER/VS is terminated for any reason, all spooled partitions are also termi- 
nated. Therefore, a program such as CICS/VS running under POWER/VS would 
be abnormally terminated. 

• Under POWER/VS, the performance of interactive teleprocessing programs might 
be affected. For example, best response time is obtained by CICS/VS when it has 
the highest priority. Under control of POWER/VS, it could not have the highest 
priority. Performance would be more adversely affected on the smaller System/370 
models. 
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JOB ENTRY CONTROL LANGUAGE (JECL) 



;?r 



a 






JECL is used to specify POWER/VS job-processing options. JECL statements do not 
override or replace DOS/VS JCL statements in any way. 

FUNCTIONS OF JECL STATEMENTS 

The following table shows the JECL statements and their functions: 



JECL Statement 



■* $$ CTL 

* $$ JOB 

* $$ EOJ 

* $$ RDR (Note I) 

* $$ LST 

* $$ PRT 

* $$ PUN 

* $$ SLI 

* $$ /* 



$$ /& 
$$ DATA 



Function 



Specifies a default input class 

Indicates the beginning of a POWER/VS job and 

provides handling information 

Indicates the end of a POWER/VS job 

Inserts a diskette file into the input stream 

Provides handling information for printed 

output 

Provides handling information for punched 

output 

Inserts data from a sublibrary into the job 

stream 

Used in a source statement library book to 

indicate the end of a DOS/VS job step (used 

for the SLI statement only) 

Used in a source statement library book to 

indicate the end of a DOS/VS job (used for 

the SLI statement only) 

Inserts data into a book retrieved from a 

source statement library. 



Note I. Not supported in the component release of POWER/VS. 



> 



When POWER/VS is in operation, JECL may or may not be used to delimit jobs. If 
JECL is used to delimit jobs, job entries are contained between the POWER/VS 

• $$ JOB and * $$ EOJ cards. An * $$ JOB card encountered in the input stream 
without a preceding * $$ EOJ card is used as a delimiter for the previous 
POWER/VS job. If JECL is not used to delimit jobs, job entries are contained 
between the DOS/VS // JOB and /& cards. (If /& is missing, POWER/VS creates one 
when the next // JOB card is encountered). The POWER/VS job name is then copied 
from the DOS/VS job name. Other JECL statements can still be included. 

Since JECL statements begin with an asterisk-blank, job control treats them as com- 
ments when POWER/VS is not in control. 

The CTL, JOB, and EOJ statements should be presented at DOS/VS job control time. 
When in the middle of a user data stream, they are treated as POWER/VS control state- 
ments. The RDR, LST, PUN, SLI, and DATA statements can be included anywhere in 
the input stream. More than one LST or PUN statement is allowed per POWER/VS job. 

JECL must always be used in a writer-only partition, but is used with these restrictions: 

• RDR, CTL, SLI, and DATA statements are treated as comments. 

• LST and PUN statements are recognized at job control time, or when user gener- 
ated and written to SYSLOG. 

• A number of JOB statement parameters are not meaningful and are ignored. 

JECL statements will be considered data if read by a writer-only partition. This allows 
source statement books containing JECL to be catalogued. 



Job Entry Control Language 51 



FORMATS OF J ECL STATEMENTS 

Each JECL statement consists of the following fields. Refer to Figure 10. 

1. Identification field. Contains, the characters * $$ (asterisk-blank-dollar-dollar) in 
columns 1 through 4. 

2. Operation field. Specifies the JECL operation. It can directly follow the second 
dollar sign or be separated from the second dollar sign by one or more blanks. 
At least one blank must be placed between the operation field and the operand 
field. 

3. Operand field. Contains one or more keyword or positional parameters, separated 
by commas. Keyword and positional parameters cannot be mixed within one 
statement. 

Note. Some POWER/ VS features are supported only through keyword notation. 

Positional parameters must be specified in a fixed order. If a positional parameter 
is omitted, its delimiting comma must be coded. If trailing parameters are omitted, 
trailing commas can also be omitted. If no parameters are specified, the entire 
operand field can be omitted. In the case where a comment field is present and 
the entire operand field is blank, the omitted operand field is indicated by a comma, 
which is preceded and followed by at least one blank. If the operand field cannot 
be contained on one card, a continuation card can be produced according to the 
following rules: 

• The operand field can be broken after a comma that separates two parameters, 
and can be continued on the next card starting anywhere between columns 
6 and 16 (inclusive). Column 72 of the first card must contain a non-blank 
character. This process can be repeated for as many cards as are necessary. 

• Columns 1 to 4 of each continuation statement must contain * $$ 
(asterisk-blank-dollar-dollar). 

• Column 72 of a non-continued (single) statement or a last continuation 
statement must be blank. 



i 



Note. In a writer-only partition, continuation of a * $$ JOB card is not recognized. 




Figure 10. Format of JECL statements 



( 
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5. 



Comments field. Can contain any information considered helpful by the user. The 
comment field can be broken anywhere and continued on the next statement, 
in any column, subject to the same continuation rules given for the operand field. 

Sequence field. Contains up to eight characters of optional information used for 
control statement identification. If present, the sequence field is positionally 
dependent and must be coded starting in column 73. 



Underlined and capitalized parameter names and values that appear in the individual 
JECL statement formats indicate defaults that apply when the parameters are not 
specified. 

CTL Statement The CTL statement establishes the default input class that is assigned to all jobs whose 

input class was not assigned in a JOB statement. A CTL specification overrides an input 
class specification that may have been made through a PSTART command. 

The CTL statement can be placed at any POWER/VS job boundary in the input stream, 
and becomes effective immediately. It remains in effect until the next CTL statement 
is read or until the read task is stopped with a PSTOP command. 



CTL 



CLASS= 



A 
class 



(keyword form only) 



class. Specifies the input class to which any subsequent jobs are assigned if they do 
not contain a class specification in their JECL JOB statement. Class can be specified 
as an alphameric character from A-Z or 0-4. For a more detailed discussion of class, 
refer to the "POWER/VS Concepts and Facilities". 



Examples: 



* $$ CTL CLASS=3 Jobs without a class specification in the JECL JOB 

card are executed in partition F3 (partition- 
dependent). 

* $$ CTL CLASS=B Jobs without a class specification in the JECL JOB 

card are executed in any partition that has class B 
assigned to it (partition-independent). 

JOB Statement The * $$ JOB statement can be placed anywhere in the DOS/VS job stream to specify 

POWER/VS job attributes and to begin a POWER/VS job. The * $$ EOJ statement is 
normally used to end a POWER/VS job. However, if the EOJ statement is not used, 
the * $$ JOB statement of the next job delimits this job. If the JOB statement is 
omitted, POWER/VS jobs are delimited by the DOS/VS // JOB and /& statements, 
and the POWER/VS job name is copied from the DOS/VS job name. 

Note. It is allowable to have multiple DOS/VS fobs within a POWER/VS fob, and vice 
versa. 




JNM= 



/ autoname VT 



Ijob 



name 



)] 



1 



(keyword form) 



' ^disposition 



[,PRI=priority] 
[,CLASS=class] 
(2USER=user-information] 
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J0B [" AUTONAME l (positional form) 

[ jobname J 

P 1 

'[disposition J 
, [priority] 
, [class 1 



Note. User information cannot be specified with the positional form. 
Operands 

jobname. Specifies the name by which the job is known to POWER/ VS. If the job 
contains several DOS/VS jobs, they are all logged in POWER/VS by the job name in 
the JECL JOB statement. The default name, AUTONAME, is assigned if jobname is 
not specified. 

A JECL jobname specification can be from 1 to 8 alphameric characters, beginning with 
an alphabetic character. However, use of the job names ALL, HOLD, FREE, RJE, 
LOCAL, or one-character job names should be avoided as they may conflict with some 
POWER/VS operator commands. 

disposition. Specifies how POWER/VS will route and schedule the associated entry in 
the read queue. 

A read entry must have one of the following disposition attributes: 

D Dispatch and delete. The job is automatically scheduled by POWER/VS in 
accordance with the class and priority attributes. On completion of job execution, 
the read entry is deleted from the read queue and data file space is released. D is 
the default value if no disposition is specified. 

H Hold job. The entry remains in the read queue; it is not dispatched by POWER/VS 
until the disposition attribute is changed to D or K through the PALTER or 
PRELEASE command. 

K Dispatch and keep. The entry is automatically scheduled by POWER/VS in 
accordance with the class and priority attributes. On completion of job execution, 
the read entry is not deleted from the read queue, and the disposition of the 
entry becomes L. 

L Leave in queue. The entry remains in the read queue; it is not executed by 
POWER/VS until the operator specifically changes the disposition attribute to D 
or K by using the PALTER command. 

Input specifications for disposition, priority, and class are ignored in writer-only parti- 
tions. 

priority. Specifies the priority assigned to this job in both input and output queues. 
It is specified as a single digit from to 9. Nine is the highest priority. If the priority 
parameter is not specified, POWER/VS assigns the default priority defined in the PRI 
parameter of the POWER macro. Jobs are dispatched on a first-in, first-out basis within 
priority, within class. 

class. Assigns a class to the job entry in the input queue. It can be specified as an 
alphameric character from A-Z or 0-4. This parameter can be used to group jobs that 
require the same resources for execution. 

Classes through 4 have a specific meaning and are partition dependent classes; jobs 
with class can only be selected for execution in BG, jobs with class 1 can only be 
selected for execution in Fl , and so on. Classes A through Z are partition-independent 
classes; such jobs can be executed in any partition with a matching class. When the 
JOB statement is coded in its positional form, class may be coded as BG, and class 
1 to class 4 may be coded as Fl to F4. 



( 
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If class is not specified, the input class specified in the CTL statement applies; if no 
CTL statement is in effect, the class is established by the PSTART command. If no 
class is specified at all, default class A is assigned. 

user-information. Up to 16 bytes of user information can be specified. This information 
is printed on SYSLOG when the execution read task encounters an * $$ JOB statement 
(if JLOG=YES). It also appears in the POWER/VS account records and in separator 
pages. User information must be specified within quotes. 



Examples: 



JOB JNM=PAYROLL,PRI=0 

or 
JOB PAYROLL„0 



JOB JNM=TEST,DISP=H 

or 
JOB TEST,H 



Job named PAYROLL is given the low- 
est priority in its class. Disposition 
defaults to D. Class defaults to the 
CTL statement or PSTART command 
specification. 



Job named TEST is placed in the hold 
state. Priority is that specified at 
POWER/VS generation. Class defaults to 
the CTL statement to the PSTART 
command specification, or to A. 

JOB JNM=ASSEMBLY,PRI=2,CLASS=2 

or Job named ASSEMBLY is given a 

JOB ASSEMBLY „2,F2 priority of 2 within input class 2 

(partition F2). Disposition defaults 

to D. 



JOB , comment 



Job takes default name, AUTONAME. 
Note that a "blank-comma-blank" 
preceeds the comment field. 



EOJ Statement 



RDR Statement 



The EOJ statement marks the end of the POWER/VS job and, if used, is normally placed 
at the end of a DOS/VS job. However, if this statement is presented at any other time 
than DOS/VS job control time, it is still acted upon by POWER/VS. 



EOJ 



The RDR statement is used to insert a 3540 diskette file into input being read from 
a card reader. It is also possible to read both data and JCL from the 3540 and then 
to spool the input, or to immediately process the input in a writer-only partition. 



Note. The 3540 is not supported in the component release of POWER/VS. 



Case 1: Reading Exclusively From The 3540 



To read exclusively from the 3540, issue the following format of the PSTART command 
(see "POWER/VS Operator Command Language "): 



PSTART RDR,3540addr,Tilename'[,maxno] [,S] 

JCL and data are both on one 3540 SYSIN file. Note that a RDR statement is not 
used. 
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Case 2: Merging 3540 Data File With Card Reader Input 



To merge a 3540 data file with input from a card reader, issue the following format 
of the PSTART command: 

PST ART RDR,uraddr ,3 540addr 

This initiates the read task; input is entered from the card reader. When a RDR statement 
is encountered (which might be the first card), input is continued from the 3540. At 
the end of the 3540 file, input is again accepted from the card reader. 



I RDR LUN=logical-unit-numberJ (keyword form) 

: ,FID='file-id'] 

_' |number-of-diskettesn 

;vsc=s] 

RDR [logical-unit-number] (positional form) 



^file-id'] 



number-of-diskettes 



.] 



H 



logical-unit-number. Specifies the programmer logical unit number (SYSnnn) used by 
the user program to read the input data file. SYSnnn must not be specified for SYSIN 
files. 

'file-id'. Specifies the file name (in quotes) that appears in the HDR1 label on the 
3540 diskette. One to eight alphameric characters are specified. If this parameter is 
omitted, POWER/VS reads the file specified by the first non-secured HDR1 label found 
on the diskette that is currently mounted in the 3540. Record size is acquired from 
the HDR1 label. 

number-of-diskettes. Specifies the maximum number of diskettes to be read. One to 
three digits can be specified. Allowed values are 1 to 255. The default value is 1. Reading 
stops after the specified number of diskettes are processed, or after reading a diskette 
whose HDR1 label indicated that it was the last vdlume of the file. 

S. Specifies volume sequence checking. If omitted, no sequence checking takes place. 
Sequence numbers must start with 1 and must be incremented by 1. 

Example: 

With JCL in the card reader, and data on the 3540, the operator enters a PSTART 
command for card reader X'OOC': 

PSTART RDR 5 00C,00B 

This command tells POWER/VS to start a read task at address X'OOC' with the ability 
to read also from a 3540 device at address X'OOB'. Both devices belong to the read 
task and cannot be used by any other partition or POWER/VS task until the read 
task terminates. 



( 
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LST or PRT Statement 



The Following cards are in X'OOC': 

*$$J0BJNM=EX1,PRI=9 

// JOB EX1 

// ASSGN SYS008,X*00B* 

// DLBL FILE/FILE-ID'„DU 

// EXTENT SYS008 

// EXEC PROG 

* $$ RDR SYS008, 'FILE-ID', 2 
/* 

/& 

* $$ EOJ 



Note. The SYS008 specification in the * $$ RDR statement would not be required 
if the symbolic unit was assembled into the DTFDU. 



The RDR statement causes the read task to suspend card reading and to read a 
maximum of 2 diskettes of the data file named FILE-ID. Records on the 3540 can 
be from 1 to 128 bytes long and are not examined for JCL or JECL control 
statements by either the read task or the execution processor. When the end of the 
FILE-ID file is reached, card reading resumes. 

During execution, the user program might not read all of the FILE-ID records spooled 
by the read task. To prevent the remainder of the records from being passed to job 
control, any request to the SYSIN device causes POWER/ VS to skip records until the 
end of the FILE-ID file. 



The LST (or PRT) statement defines the attributes of the intercepted list output of 
a POWER/VS job. 

Multiple LST statements can occur within a POWER/VS job. They can define multiple 
printers, real and dummy, and they can define and redefine the attributes of the output 
of the job. When LST statements appear within the spooled input data for a user program 
they, in effect, "segment" the output for that program. 

The specifications of a particular list statement remain in effect until a subsequent LST 
statement with the same LST parameter (same printer) is encountered, or until the 
end of the POWER/VS job. Each * $$ LST statement creates a separate list entry. 

If a job does not include a LST statement, default values established during POWER/VS 
generation are assumed. LST statements do not require that the * $$ JOB and * $$ 
EOJ statements also be used. 

LST and PRT are equivalent operation codes. LST is used throughout this manual. 
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LST 
PRT 



ion) J 



( disposition 

b cLA HiJ] 

,REMOTE = remid] 

FNO= j M 

' ( forms-number 



(keyword form) 



i] 



[,JSEP=sep] 

- <-L 



COPY= 

' ( number-of-copies 

,RBM=(norbml ,norbm2)] 
[,LTAB=linetab] 
[,RBS=norbs] 

[,UCS=(phasename [, option] )] 
[ ,FCB=phasename ] 

[LST=listaddr] 



n 



(lst) 

(PRT/ 



D 

disposition 



Ml 

LclassJ J 



forms-numberj 

P- 

' | number-of-copies 
_(tapeaddr[,X'ss'])_ 
,[norbml] 
, [linetab] 



(positional form) 



Operands 

disposition. Specifies the disposition of the printed output after execution of the job. 
The disposition specification options are listed below: 

D Process and delete. The list entry is automatically written to a printer in accordance 
with its class and priority attributes. 

H Hold. The list entry remains in the list queue; it is not written to a printer by 
POWER/VS until the disposition attribute is changed to D or K by means of the 
PALTER or PRELEASE command. 



K 



N 



Process and keep. The list entry is automatically written to a printer in accordance 
with its class and priority attributes. When printing is completed, the list entry 
is not deleted from the list queue, and the disposition of the entry becomes L. 

Leave in queue. The list entry remains in the list queue; it is not written to a 
printer until the operator changes the disposition attribute to D or K using the 
PALTER or PRELEASE command. 



Output without spooling. If N is specified, print requests are not intercepted. 
Output is written directly, without spooling. 

T Spool to tape. The output is spooled to tape intermediate storage. PSTART is 
used to initiate printing. 

If the disposition specification is omitted, D is assumed. 



( 
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If the N option is specified and the device is not available at execution time, a message 
is issued and list output is spooled. 

D, H, K, I and L are only valid when the output is spooled to disk. 

When the output is to be printed at a terminal, N and T are invalid specifications. 

Note. There is no comma between disposition and class in the positional form of the 
LST statement. 

class. Specifies the class of the job's printed output. It can be specified as any alphabetic 
character. The partition-dependent input classes, through 4 cannot be specified for 
output. 

Class can be used in conjunction with "forms-number" to group like types of printed 
output. A list task can be started by class to process the output. Class is only meaningful 
when the output is spooled to disk. If class is specified and the positional form is 
used, disposition must also be specified. 

If the class operand is omitted, class A is assigned. 

remid. Specifies the "to" remote-id to which list output is to be routed. Each list entry 
also has a "from" remote-id, which identifies the user who submitted the job initially. 

"remid" can be a number from to 200. Numbers 1 to 200 represent specific remote 
users. If remid is 0, list output is directed to the central installation. 

If this parameter is omitted or if the positional form of the * $$ LST statement (which 
does not support this parameter) is used, list output is routed to the central location 
if the job was submitted locally, or is routed to the LSTROUT specification in the 
PRMT macro if the job was submitted remotely. 

forms-number. Specifies the type of forms to be used, "forms-number" is one to four 
alphameric characters long. If forms-number is not specified, it is assumed to be four 
blanks, representing the installation's standard forms. When a list task prepares to process 
output from a list entry, it determines whether this forms-number matches that of the 
previous list entry. If the numbers match, the list task processes the output. If the 
numbers do not match, message 1Q40A is issued. 

sep. Specifies the number of job separator pages (0 to 9). If not specified, the value 
defined during POWER/VS generation is assumed. 

number-of-copies. Specifies the number of copies to be printed. 

"number-of-copies" is one or two digits long. If not specified, 1 is assumed. If or 
00 is specified, one copy is produced. This parameter is ignored when the output is 
not spooled to disk. If additional copies are required when disposition is T, the tape 
must be reprinted. 

tapeaddr. Specifies the hardware address of the tape drive to be used for spooling when 
the job is being executed. Its format is one of the following: 

cuu 
X'cuu' 
cuu,X'ss' 
X'cuu',X'ss' 

X'ss' specifies the density of the tape, where "ss" is a standard DOS/VS code. (The 
X'ss' parameter can only be specified in the keyword form of LST). 

The tapeaddr parameter forces a disposition of T. If (DISP=T) is specified and tapeaddr 
is omitted, the operator will be asked to specify the tape address at job execution time. 

Multiple files can be written to a single tape. Multivolume files are also supported. No 
label checking is performed. 

norbml. Specifies the number of list records that must be intercepted before message 
1Q52I is sent to the operator. This parameter is one to six digits long. If norbml 
is omitted, the value defined during POWER/VS generation is assumed. 
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norbml. Specifies the number of list records that must be intercepted before message 
1Q52I is sent to the operator. This parameter is one to six digits long. If norbml is 
omitted, the value defined during POWER/VS generation is assumed. 

norbm2. Specifies the additional number of list records intercepted each time before 
message 1Q52I is sent out again. The number is one to six digits long. If norbm2 is 
omitted, the preceding comma as well as the parentheses can be omitted, and the value 
defined during POWER/VS generation is assumed. This value is also assumed when the 
positional form of the LST statement is used. 

linetab. Specifies the carriage control tape format to be used when print requests are 
intercepted. This parameter is 26 digits long; each subparameter is two digits. If linetab 
is not specified, the LTAB parameter defined during POWER/VS generation is used. 
The format of linetab is: 

d0,dl,d2, ... dl2 
dO is the distance between the channel 12 and the first punch; dl is the distance 
between the first punch and the channel 1 punch; d2 is the distance between the 
first punch and the channel 2 punch; and so on. If channel 1 is the first punch, 
distance dl is expressed as 00. If a channel is not punched, 00 must be specified 
for that channel. See "Examples". 

Any linetab specification is ignored if an FCB phase name is also present in the * $$ LST 
statement. An LFCB macro issued in the problem program updates the LTAB format. 

Note. It is advisable to use the forms number parameter in conjunction with the linetab 
parameter. This causes the list task to pause, thus allowing the operator to mount the 
correct carriage control tape on the printer. 

norbs. Specifies the number of list pages intercepted before the output is segmented. 
This number overrides the POWER/VS generation specification of the RBS parameter 
of the POWER macro. 

This parameter can be one to six digits long. A zero means that no segmentation will 
take place. 

Each LST statement, besides possibly specifying a different norbs value, resets record 
count to zero; that is, a new segment is started. A new count is also started when 
an LFCB macro instruction is issued, "norbs" cannot be specified in the positional 
form of LST, and is valid only when spooling to disk. 

phasename. Specifies the name of the phase under which an FCB or UCS buffer (UCB) 
image is cataloged in the core image library. An optional subparameter can be specified 
along with the UCB phasename. The format of the parameter then becomes 
(phasename,option), where "option" can be specified as F, C, CF, or FC. 

F Signifies that the UCB is to be loaded with the folding operation code to 

permit printing of uppercase for lowercase bit configurations. 
C Prevents data checks from being generated because of print line mismatches 
with the UCB. 
The specified core image library phase is loaded into the FCB or UCB when a list 
task starts processing the output related to the LST statement. 

When a LST statement with an FCB phase name specification is encountered by the 
execution processor, the specified buffer image is read to update the internal LTAB 
representation to reflect the new buffer. Any LTAB specification in the LST statement 
is therefore ignored if FCB is also specified. The FCB specification for a non-FCB printer 
is accepted, but is only used to update the LTAB. 
This parameter is not supported by the positional form of LST. 



( 
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listaddr. Specifies either the logical or physical address of the output printer for the 
list entry being created. The address can be either in the form SYSxxx, where xxx 
is LST or any valid programmer logical unit; or in the form cuu (or X'cuu'), which is 
the channel and unit number of an actual or a dummy printer. (For a discussion of 
dummy printers, refer to "Dummy Printers and Punches" in the "POWER/VS Concepts 
and Facilities"). 

If this parameter is omitted, the default is the first printer address specified at partition 
start-up. 

This parameter is needed when multiple printers are used to print multiple reports 
produced by a single program. This parameter is not supported by the positional form 
of the LST statement. 

Examples: 

In this job, printed output is spooled to disk and requires the installation's special form 
number 32A. One copy is requested, and the STDLINE value is used. The linetab 
parameter defines a carriage control tape for a page of 66 lines. Channel 3 is punched 
four lines below channel 1; no channels other than 1, 3, and 12 are used. 

* $$ LST FNO=32A,LTAB=l 0000004000000000000000056 

or 

* $$ LST ,32A„, 10000004000000000000000056 



LST DISP=N 

or 
LST N 



Print requests are not intercepted, but 
are sent directly to the physical device. 



* $$ LST DISP=T,TADDR=283 

or 

* $$ LST T„283 



Printed output is spooled to tape unit 
283. 



PUN Statement 



* $$ LST CLASS=A,FNO=32A,RBS=100 Printed output is designated class A. 

Special form number 32A is required. 
Printed output is segmented after 
every 100 pages. 



The PUN statement defines the attributes of the intercepted punch output of a 
POWER/VS job. 

Multiple PUN statements can occur within a POWER/VS job. They can define multiple 
punches, dummy and real, and they can define and redefine the attributes of the output 
of the job. When PUN statements appear within the spooled input data for a user pro- 
gram they, in effect, "segment" the output for that program. 

The specifications of a particular PUN statement remain in effect either until a 
subsequent PUN statement for the same punch is encountered or until the end of the 
POWER/VS job. Each * $$ PUN statement creates a separate punch entry. If a job 
does not- include a PUN statement, default values established during POWER/VS 
generation are assumed. 

PUN statements can appear anywhere in the POWER/VS job, including in user program 
spooled input data. PUN statements do not require that * $$ JOB and * $$ EOJ state- 
ments also be used. 
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*$$PUN 



[disp=!£ .,. 

L ( disposition 

[ CLAS Hissl] 

[,REMOTE=remid] 
,FNO= 



I] 



(keyword form) 



[,FNO= j 



i] 



forms-number 
[,JSEP=sep] 

r 5 COPY=j a . {] 

L ( number-of-copies ) J 

[,TADDR=(tapeaddr [,X'ss'] )] 

[,RBM=(norbml ,norbm2)] 

[,PUN=punaddr] 

[,RBS=norbs] 



* $$ PUN 



D 

disposition 



forms-number 



A 11 

classj J 



(positional form) 



\ni 



number-of-copiesj 
(tapeaddr[,X'ss']) 
,[norbml] 



Operands 

disposition. Specifies the disposition of the punched output after execution of the job. 
The disposition specification options are listed below: 

D Process and delete. The punch entry is automatically written to a punch in 
accordance with its class and priority attributes. 

H Hold. The punch entry remains in the punch queue; it is not written to a punch 
by PQWER/VS until the disposition attribute is changed to D or K by means 
of the PALTER and PRELEASE command. 

I Return output to input queue. In some situations it may be useful to return the 
punch output of a POWER/ VS job directly to the input queue. For example, in 
situations where the assembler normally stores its output (including JCL) on tape 
for subsequent input to a catalog run, it can, using POWER/ VS, store output 
directly into the input queue. The input entry created has the same jobname, 
remote-id, and priority as the entry producing the output. Class becomes that 
specified in the PUN statement; disposition becomes D. 

Specification of the I option suppresses count-driven output segmentation. Also, 

the multiple copies specification is ignored. 

This facility should only be used for jobs producing punch output in executable 

format. 
K Process and keep. The output is automatically written to a punch in accordance 

with its class and priority attributes. When punching is completed, the punch entry 

is not deleted from the punch queue, and the disposition of the entry becomes 

L. 
L Leave in queue. The job remains in the punch queue; it is not written to a punch 

until the operator changes the disposition attribute to D or K by means of the 

PALTER command. 



( 
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N No spooling. If N is specified, punch requests are not intercepted. It allows direct 
punch writer capabilities without spooling. 

T Tape spooling. The output is spooled to tape. 

If the disposition specification is omitted, D is assumed. 

If the N option is specified, and the device is not available at execution time, message 
1Q46I is issued and punch output is spooled. 

D, H, K and L are only valid when the output is spooled to disk. 

When the output is to be punched at a terminal, N and T are invalid specifications. 

Note. There is no comma between disposition and class in the positional form of the 

PUN statement. 

class. Specifies the class of the punch output of the job. It can be specified as any 

alphabetic character. The partition-dependent input classes, 0" through 4, cannot be 

specified for output. Class can be used in conjunction with forms-number to group 

like types of punch output. Punch tasks can be started by class to process the output. 

Class is only meaningful when the output is spooled to disk. If class is specified and 

the positional form is used, disposition must also be specified. If the class operand 

is omitted, class A is assigned. 

remid. Specifies the remote-id to which punch output is to be routed ("to" remote-id). 

Each punch entry also has a "from" remote-id, which identifies the user who submitted 

the job. 

"remid" can be a number from to 200. Numbers 1 to 200 are specific remote users. 

If remid is 0, punch output is directed to the central installation. 

If this parameter is omitted or if the positional form of the * $$ PUN statement is 
used, punch output is routed to the central location for locally submitted job entries 
or is routed according to the PUNROUT specification in the PRMT macro for job entries 
submitted remotely. 

forms-number. Specifies the type of card forms to be used, "forms-number" is one 
to four alphameric characters long. If forms-number is not specified, it is assumed to 
four blanks, representing the installation's standard card forms. When a punch task 
prepares to process output from a punch entry, it determines whether this forms-number 
matches that of the previous punch entry. If the numbers match, the punch task 
processes the output. If the numbers do not match, message 1Q40A is issued. 

sep. Specifies the number of job separator cards (0 to 9). If not specified, the value 
defined during POWER/VS generation is assumed. The positional form of the PUN 
statement does not include this parameter. 

number-of-copies. Specifies the number of copies to be punched from the punch entry, 
"number-of-copies" is one or two digits long. If not specified, 1 is assumed. If or 
00 is specified, one copy is produced. This parameter is ignored when the output is 
not spooled to disk. If additional copies are required when disposition is T, the tape 
must be repunched. 

tapeaddr. Specifies the hardware address of the tape drive to be used for spooling when 
the job is executed. Its format is one of the following: 

cuu 
X'cuu' 
cuu,X'ss' 
X'cuu',X'ss' 

X'ss' specifies the density of the tape, where "ss" is a standard DOS/YS code. (The 
X'ss' parameter can only be specified in the keyword form of PUN.) 

The tapeaddr parameter forces T if invalidly specified. If DISP=T and tapeaddr is 
omitted, the operator is asked to specify the tape address at job execution time. 

Multiple files can be written to a single tape. Multivolume files are also supported. No 
label checking is performed. 
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norbml. Specifies the number of punch records that must be intercepted before message 
1Q52I is sent to the operator. This parameter is one to six digits long. If norbml 
is omitted, the value defined during POWER/VS generation is assumed. 

norbm2. Specifies the additional number of punch records intercepted each time before 
message 1Q52I; is sent out again. The number is one to six digits long. If norbm2 is 
omitted, the preceding comma as well as the parentheses can be omitted, and the value 
defined during POWER/VS generation is assumed. This value is also assumed if the 
positional form of the PUN statement is used. 

norbs. Specifies the number of punch records intercepted before the output is segmented. 
This number overrides the POWER/VS generation specification in the RBS parameter 
of the POWER macro. 

This parameter can be one to six digits long. A zero means that no segmentation will 
take place. 

Each PUN statement, besides possibly specifying a different norbs value, resets record 
count to zero; that is, a new segment is started. 

"norbs" cannot be specified in the positional form of PUN. 

punaddr. Specifies either the logical or physical address of the output punch for the 
punch entry being created. The address can be either in the form SYSxxx where xxx 
is PCH or any valid programmer logical unit; or in the form cuu (or X'cuu'), which is 
the channel and unit number of an actual or a dummy punch. (For a discussion of 
dummy punches, refer to "Dummy Printers and Punches" in the "POWER/VS Concepts 
and Facilities"). If this parameter is omitted, the default is the first punch address 
specified at partition start-up. 

This parameter is needed when multiple punches are used to punch multiple card files 
produced by a single program. 

Note. The address 01 D should not be used for a dummy punch on the System/ 370 
Models 115 and 125. 



Examples: 



* 


$$ PUN FNO=6509 




or 


* 


$$ PUN ,6509 


* 


$$ PUN DISP=N 




or 


* 


$$ PUN N 


* 


$$ PUN DISP=T,TADDR=285 




or 


* 


$$ PUN T„285 



Punch output requires the special card 
forms "6509". One copy is requested. 



Punch requests are not intercepted, but 
are sent directly to the punch unit. 



Punch output is spooled to tape unit 285. 



SLI Statement 

At execution time, the * $$ SLI (source library inclusion) statement causes the private 
and system source statement libraries to be searched for a book, which, when found, 
is inserted into the job stream. The private library, if one is assigned to the POWER/VS 
partition, is searched first. 

An SLI statement does not require that * $$ JOB and * $$ EOJ statements also be 
used. 

* $$ SLI [sublib.] bookname 

sublib. Specifies the name of the sublibrary to be searched. Allowed sublibrary names 4 

are A through Z, through 9, $, #, or @. Sublibraries A, C, D, E, F, and Z are 1 

already defined as special purpose libraries in DOS/ VS. This parameter is optional. 
If omitted, the SUBLIB specification at POWER/VS generation is used. 
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bookname. Specifies the book name to be searched for and inserted into the job stream. 

Books can be cataloged in the source statement library (SSL) by using the DOS/VS 
program "MAINT". To include /* and /& statements in SSL books, the statements 
must be replaced by * $$/* and * $$/& delimiter statements. See the examples that 
follow the heading "DATA Statement". 



SL Update Statement 



In conjunction with SLI statements, SL update statements are used to modifiy source 
library book images placed in the input stream. (Note that these books are not modified 
in the library.) SL (source library) update statements follow an * $$ SLI statement (not 
necessary immediately), and are identified by $SLI in columns 73 - 76. Specifically, they 
can be used to add, delete, and replace statements in the book referenced by the accom- 
panying SLI statement. Columns 78 - 80 contain a sequence number. Column 77 con- 
tains one of the following codes: 

A Insert after book statement with same sequence number. 

B Insert before book statement with same sequence number. 

D Delete the book statement with same sequence number. 



other 



Replace the book statement that has same sequence number, or insert 
this statement. 



DATA Statement 



Columns 1 - 72 contain the statement being added. (For a deletion, columns 1 
are ignored.) 



72 



SL update statements and * $$ DATA statements, when one or both are used, must 
follow * $$ SLI in the same sequence as the statements in the book that they correspond 
to. See the examples that follow the heading "DATA Statement". 



The * $$ DATA statement allows the user to insert a deck of cards from the card 
reader into a book that is retrieved from the source statement library by an SLI 
statement. At execution time, the DATA statement in the job stream is matched by 
name to a DATA statement in the source book. At that point in the source book, 
the cards (read queue data records) that follow the DATA statement, up to and including 
/* or /&, are inserted. If names do not match, or if no DATA statement is present 
in the read queue, the DATA statement in the source book is ignored. 

DATA statements must be preceded by an SLI statement; otherwise they are treated 
as comments. SL update statements ($SLI in columns 73 - 76) and DATA statements 
can be used together. However, they must appear in the job stream in the same order 
as the corresponding images appear in the source book. 

The DATA statement is ignored in a writer-only partition. 

* $$ DATA name 

name. Specifies the name of the corresponding DATA statement in the source statement 
library book where data is to be inserted, "name" can be from one to eight alphameric 
characters. The first character must be alphabetic. 
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Examples: 

1. Job to insert data from the card reader into the book "ASSM". 



Job from card reader 

* $$ JOB INSERT 

* $$ SLI ASSM 

* $$ DATA INPUTA 

POWER ACCOUNT=YES 
END 



/* 
* 



Source book "ASSM" 

BKEND ASSM 

// JOB INSERT 

// EXEC ASSEMBLY 

* $$ DATA INPUTA 

* $$/& 
BKEND 



EOJ 



Resulting job stream 



/* 
/& 



JOB INSERT 
EXEC ASSEMBLY 
POWER ACCOUNT=YES 
END 



(From book "ASSM") 
(From book "ASSM") 
(From card reader) 
(From card reader) 
(From card reader) 
(From book "ASSM") 



Assume that a private source statement library is assigned to the POWER/VS 
partition. A job (read in from the card reader) references the book "XMPL" in 
that library (sublibrary B) i and contains SL update statements as well as DATA 
statements. The book statements replace the SLI statement. However, statements 
XMPL0020, XMPL0100, and XMPL0120 are overridden by the corresponding SL 
update statements in the input stream. In addition, statement $SLIA100 is inserted. 
Also, the cards between the DATA and the first /* statement in the input job stream 
replace the DATA statement in XMPL. The resulting job stream is placed in the 
read queue. 



Job from card reader 



* $$ JOB ASSEMSLI 

* $$ SLI B.XMPL 

// ASSGN SYSPCHX182' 
*■$$ DATA INPUTA 
DEFAULT POWER ACCOUNT=YES 
END 



/* 

// ASSGN 
// ASSGN 
// MTC 
* $$ EOJ 



sysipt,^^' 

SYS010,X'183' 
RUN,X*182' 



Col 73-80 



$SLI0020 



$SLI0100 
$SLIA100 
$SLI0120 



( 
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Book "XMPL" in source statement library 







Col. 73-80 


BKEND 


B.XMPL 




// JOB 


ASSEMBLE 


XMPL00I0 


// ASSGN 


syspchXiso* 


XMPL0020 


// EXEC 


ASSEMBLY 


XMPL0030 


* $$ DATA 


INPUTA 


XMPL0040 


// MTC 


WTM,SYSPCH 


XMPL0050 


// MTC 


WTM,SYSPCH 


XMPL0060 


// MTC 


REW,SYSPCH 


XMPL0070 


* ■$■$/& 




XMPL0080 


// JOB 


CATALOG 


XMPL0090 


// ASSGN 


SYSIPT,X'180' 


XMPL0100 


// EXEC 


MAINT 


XMPL0110 


// MTC 


RUNX180* 


XMPL0120 


* $$/* 




XMPL0130 


* $$/& 




XMPL0140 


// JOB 


LINK 


XMPL0150 


// OPTION 


CATAL 


XMPL0160 


INCLUDE DEFAULT 


XMPL0180 


* $$/* 




XMPL0200 


// EXEC 


LNKEDT 


XMPL0210 


* $$/& 




XMPL0220 


BKEND 







Resulting job stream placed in read queue 



DEFAULT POWER ACCOUNT=YES 
END 



$$ JOB 

JOB 
7 ASSGN 
7 EXEC 



ASSEMSLI 
ASSEMBLE 
SYSPCHX182' 
ASSEMBLY 



/ MTC 
/ MTC 
/ MTC 
& 

/ JOB 
/ ASSGN 
/ ASSGN 
/ EXEC 
/ MTC 



WTM,SYSPCH 
WTM,SYSPCH 
REW,SYSPCH 

CATALOG 

sysiptX^' 

SYS010,X'183' 

MAINT 

RUNX182' 



& 

/ JOB LINK 

/ OPTION CATAL 
INCLUDE DEFAULT 



/ EXEC 
& 
$$ EOJ 

r 



LNKEDT 



Col 73-80 

XMPL0010 

$SLI0020 

XMPL0030 



XMPL0050 

XMPL0060 

XMPL0070 

XMPL0080 

XMPL0090 

$SLI0100 

$SLIA100 

XMPL0110 

$SLI0120 

XMPL0130 

XMPL0140 

XMPL0150 

XMPL0160 

XMPL0180 

XMPL0200 

XMPL0210 

XMPL0220 



updated 

inserted 
inserted 
inserted 



modified 

updated 
inserted after 

updated 

modified 

modified 



modified 
modified 
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POWER/VS OPERATOR COMMAND LANGUAGE (POCL) 



The operator communicates with POWER/VS through the attention routine (AR). When 
the request key is pressed, the following message is displayed on SYSLOG: 

AR 1I60A READY FOR COMMUNICATIONS 
At this point, the operator can enter POWER/VS commands. (For the display operator 
console on a System/370 Model 115 or Model 125, the request key does not have 
to be pressed to give the attention routine control; the console is normally ready to 
accept attention routine commands.) 



> 



POWER/VS operator commands include: 

• Task Management commands. Used to control read/write tasks and execution 
processors. 

• Queue Management commands. Used to control the various input/output queues. 

• Miscellaneous commands. Enable the operator to, for example, align printer forms 
or save the POWER/VS account file. 

The operator commands consist of two fields, the operation field and the operand field. 
The operand field contains one or more parameters, separated by commas, or contains 
no parameters at all. The operator commands can be entered in either uppercase or 
lowercase. 

POWER/VS supports abbreviated as well as extended operation codes. All command 
options (parameters) are valid for both formats. 

The following table shows the abbreviated and the extended command codes: 



Type 


Extended 
format 


Abbreviated 
format 


Function 1 


Task 
management 

Queue 
management 

Miscellaneous 


PSTART 

PSTOP 

PGO 

PEND* 

PCANCEL 

PFLUSH 

PRESTART 

PDI SPLAY 
PALTER 
PDELETE 
PRE LEASE 

PBRDCST 
PINQUIRE 
PACCOUNT 
PSETUP 


S 
P 
G 

C 
F 

T 

D 
A 

L 
R 

B 

1 

J 


start a task or partition 
stop a task or partition 
activate a task or partition 
end POWER/VS execution 
cancel a POWER/VS status report 
flush an active job entry 
restart a write task 

display a job status 

alter attributes 

delete a job entry or a message 

release a job entry 

transmit a message 
check terminal status 
process account file 
print page layout 



< 



* The one-character operation code for PEND, (E) is not supported, since the operator might 
inadvertently end the execution of POWER/VS. 

Both the abbreviated and the extended commands are presented in this manual in the 
following format: 



Operand 

parml,parm2, parmn 



Operation 

I coml \ 
\ com2 f 

"coml" is the extended command code, and "com2" the equivalent single-character 
code. If an optional parameter is omitted, its delimiting comma must be coded. Trailing 
commas for omitted parameters are not required, however. 



POWER/VS Operator Command Language 
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The following parameters are frequently used in commands: 

jobname. Specifies the name by which the job entry is known to POWER/VS. "jobname" 

may be two to eight alphameric characters. (A one-character jobname would be treated m 

as a class specification when used in some POWER/VS operator commands.) Each job * 

entry is identified by a jobname and a jobnumber, assigned to it by the POWER/VS 

system. If the possibility of duplicate jobnames exists, the jobnumber parameter should 

also be specified. If a duplicate jobname exists and jobnumber is not specified, the 

first job entry found with the specified jobname is affected by the command. 

jobnumber. Specifies the number assigned to all input and output entries associated 
with a POWER/VS job. The jobnumber can be specified by one to five digits. The 
maximum number is 65535. The display command (PDISPLAY) can be used to obtain 
the correct jobnumber. 

Note. POWER/VS assigns internal job subnumbers to segmented output job entries. Any 
reference to a "chain " of segmented entries affects all entries in the "chain ". 

uraddr. Specifies the unit record device address associated with a read or write task. 
Its format is: 

cuu or X'cuu' 

Where: c = channel address 
uu = unit address 

partition. Specifies the partition for which the command is to be executed. The possible 
entries are: 

BG, F4, F3, F2, or Fl. 



priority. Specifies the priority of the job entry. Priority is specified as a single digit 
from to 9. Nine is the highest priority. 

queue. Specifies the queue for which the command is to be executed; that is: 

LST = the list queue 
PUN = the punch queue 
RDR = the read queue 

Both LST and PRT are valid as list queue identifiers. LST will be used throughout 
this manual. 

remid. Specifies the remote-id to which the command applies. Remote users may be 
identified by numbers from 1 to 200. A specification of indicates the central location. 

lineaddr. Specifies the line address associated with an RJE task. Its format is: 

cuu or X'cuu' 

Where: c = channel address 
uu = unit address 



TASK MANAGEMENT COMMANDS 
PSTART Command 



This command starts a POWER/VS task or brings a partition under control of 
POWER/VS. 

The task and RJE formats are used to start read/write tasks and RJE tasks, respectively. 
The partition format is used to place a partition under POWER/VS control. 

POWER/VS requires a programmer logical unit for each unit record device, each spool 
tape, or each RJE line specified in a PSTART command. If no free LUB is available 
in the POWER/VS partition, a message is displayed and the command is ignored. 



( 
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PSTART ) / task,uraddr, [class] 
S 1 I task,uraddr,tapeaddr 

' partition [,class] 

RJEJineaddr ^password] 

RDR,3540addr,'filename' [ 5 maxno] [,S] 

RDR,uraddr,3540addr 

Note. The RDR format is only for the 3540 Diskette Input/Output Unit. 

Operands 

task. Specifies the task to be started as RDR, LST, or PUN. 

RDR = read task 
LST = list task 
PUN = punch task 

When a read task is started, input entries are built from the input data. When a write 
task is started, output entries are processed in priority sequence within class. 

uraddr. Specifies the unit record device address associated with the read/write task. 
Its format is either: 

cuu or X'cuu' 

lineaddr. Specifies the line address associated with the RJE task. Its format is either: 
cuu or X'cuu' 

tapeaddr. Specifies the address of the tape unit on which a spool tape is mounted. 
Its format is: 

X'cuu' 

Only list and punch tasks can be started from a tape. If the tape is not recognized 
as a spool tape, a message is issued and the command is ignored. 

password. When an RJE line is started, a password can be set for the line by the central 
operator. This password can be any combination of up to eight alphameric characters. 
A default password is defined during POWER/VS generation, and is used if no password 
is specified by the central operator. If the password is specified in the PSTART 
command, this password is in effect until a PSTOP command is issued. If a password 
is set, a remote operator must use it to sign on. 

class. The meaning of this parameter depends on the type of task to be started. 

For a write task, "class" defines the output class(es) upon which the task operates. 
Up to four classes can be designated by specifying one to four alphabetic characters 
from A through Z. The order specified is the order in which the classes will be processed. 
If no class parameter is specified, only class A is selected. 

For a read task, "class" defines the input class that is assigned to all jobs without 
a class specification in their * $$ JOB cards, when no CTL statement is in effect. 
It may be specified as an alphameric character from A through Z or from through 
4. If no class parameter is specified, class defaults to A. 

For a partition, "class" defines the input class(es) that can be executed in this partition. 
Up to four classes can be designated by specifying one to four alphameric characters 
from A through Z or from through 4. The order specified is the order in which 
the classes will be executed. If no class is specified, only job entries with matching 
partition-type (0-4) input class are selected. 
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Note. Only one of the classes specified in the "partition" form of a PSTART command 
can be a partition-type class fie., 0-4), and the partition-type class specified must match 
the partition being started. For example: PSTART F2,AC2. 

For a more detailed discussion of class, refer to "POWER/VS Concepts and Facilities". 

partition. Specifies the partition to be brought under POWER/VS control as: 

BG, F4, F3, F2 or Fl 

If the partition specified is already controlled by POWER/VS, the PSTART command 
acts as a normal AR START command. If the partition is not under POWER/VS control, 
the PSTART command first brings it under control of POWER/VS and then performs 
the AR START function. 

If the partition to be placed under POWER/VS control is still active, or not supported 
by the DOS/VS system, or if it does not have lower priority than the POWER/VS 
partition, a message is issued and the command is ignored. 

3540addr. Specifies the address of the 3540 Diskette Input/Output Unit associated with 
the read task. Its format is: 

cuu or X'cuu' 

'filename'. Specifies the name, in quotes, of the file to be read, which must be the 
same as the name in the HDR1 label on the 3540 diskette. This name is the file identifier 
obtained from the DLBL statement when the file was created. 

maxno. Specifies the maximum number of 3540 diskettes to be read. The largest possible 
value is 255; default is 1. The RDR task terminates when the specified number of 
diskettes have been read or after reading a diskette whose HDR1 label indicates it is 
the last diskette in the file. 

S. Specifies volume sequence checking. If specified, the sequence number of the first 
volume must be 1, and succeeding volumes 2, 3, etc. 

uraddr,3540addr. Specifies a card reader and 3540 Diskette Input/Output Unit, 
respectively. A data file from the 3540 is to be inserted into the input from the card 
reader to create a single sequential input stream. This parameter has the format: 

cuu,cuu or X'cuu' ,X'cuu' 

See the "RDR Statement" under "POWER/VS Job Entry Control Language" for a 
discussion of the complete procedure to merge card reader input and 3540 files. 

Examples: 

PSTART RDR,00C,2 Start read task on X'OOC. Assign class 2 to all 

jobs without specific class assignment. 
PSTART LST,00E,AB Start list task for class A and B. 

S PUN,00D,X'285' Start tape punch task on X'OOD' from tape mounted 

on 285. 
PSTART BG Bring BG under control of POWER/VS. Select input 

class only. 
PSTART F1,AB Bring Fl under control of POWER/VS. Select input 

classes A and B only. 
PSTART RJE,030,TORONTO Start RJE task on line 030. TORONTO is the 

security password. 

PSTART RDR,00B,'FILE-ID',31 

Start a read task on a 3540 on X'OOB'. Read 
up to 31 diskettes on the file called 'FILE-ID'. 
Reading stops after 3 1 diskettes or after reading 
a diskette with a last diskette indicator in its label. 

PSTART RDR,00C,00B Start read task on X'OOC'. Reading can also be 

done from a 3540 on X'OOB'. 



< 
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PSTOP Command 

PSTOP terminates a POWER/VS task or releases a partition from POWER/VS control. 

When a read task is stopped, further input processing is terminated, and the current 
read entry is not placed in the input queue. 

When a write task is stopped, further output processing is terminated, but the current 
job entry segment is not deleted from the output queue. When a write task is restarted, 
processing starts either at the first record or next record of the same job entry segment, 
or starts by processing the next job entry, depending on the parameters specified in 
the PSTOP command. 

For read/write or RJE tasks, POWER/VS acknowledges the PSTOP command with a 
message at both the central location and at the terminal. 

j PSTOP ) I uraddrf",EOJ "j 

fp I j [^RESTART] 

j partition 

[ lineaddr[,EOJ] 

Operands 

uraddr. Specifies the unit record device address associated with the read/write task being 
stopped as: 

cuu or X'cuu' 

EOJ. Command to stop the task when it has completed processing the current job 
entry. This parameter should always be specified for RJE tasks, unless an emergency 
occurs. 

RESTART. Specifies that when the task is started again, processing of the stopped 
job entry will begin at, the record following the last one processed before the PSTOP 
command was issued. RESTART applies only to output processing. 

Note. If RESTART is not specified along with uraddr, processing will begin at the first 
record of the current job entry when this task is started again (via PSTART). 

partition. Specifies the POWER/VS controlled partition to be stopped as: 
BG, F4, F3, F2, or Fl 

Wrien a partition is stopped by a PSTOP command, it is also released by PdWER/VS. 

This* form of the PSTOP command is not effective until processing of the current read 
entry is completed. 

Aftgr the partition is released by POWER/VS, SYSRDR and all assignments to 
POWER/VS controlled devices for this partition are released. (It is the user's responsi- 
bility to re-assign these devices when the partition is restarted.) The partition can now be 
started as a normal batch partition. To restart it as a POWER/VS controlled partition, 
the DOS/VS STOP or UNBATCH command should be issued, followed by a PSTART 
command. 

lineaddr. Specifies the line address associated with the RJE task. It has the format: 
cuu or X'cuu' 

Examples: 

PSTOP 00E,EOJ Stop write task operating on 00E after completion 

of the current list entry. 

PSTOP F3 Release F3 from control of POWER/VS after 

completion of the current read entry. 
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PSTOP 00D,RESTART 



PSTOP 030 



Stop write task operating on 00D. When the task 
is restarted, processing of the stopped entry 
continues at the point of interruption. 

Stop the RJE task operating on line 030, 
immediately. If this task is reading, the input 
records already processed are lost. If the task 
is writing, output starts from the first record 
of the list entry when the task is restarted. 



PGO Command 



PEND Command 



PGO reactivates a POWER/ VS task that is waiting for an operator response. Write tasks 
are reactivated by using the uraddr parameter. Execution processors are reactivated by 
the partition,cuu parameter. 

The PGO command is normally used after an action-type message is issued to the 
operator from POWER/ VS. It is not used to restart partitions or tasks stopped by a 
PSTOP command. 

Note. Read tasks, operating on card readers that give device end interrupt when they 
are readied, are automatically reactivated when the device end occurs. They do not need 
a PGO command. 

PGO | (uraddr ) 

G ( ( partition, cuu f 

Operands 

uraddr. Specifies the unit record device to be reactivated. It has the format: 
cuu or X'cuu' 

partition, cuu. Specifies the partition and unit record device address whose output is 
being spooled to tape, "partition" can be: 

BG, F4, F3, F2, or Fl 



Examples: 
PGO 00E 

G BG,00E 



Reactivate list task after, for example, 
aligning printer forms. 

Reactivate BG after mounting a new 
spool tape for printer output. 



The PEND command is used to terminate the POWER/VS program. Unless KILL is 
specified, all active tasks are allowed to continue until the job entry they are currently 
processing is completed. POWER/VS controlled partitions are released as soon as the 
job corresponding to the current input entry is terminated. After all supported parti- 
tions are released and all readers and writers have stopped, the POWER/VS partition is 
released, and the system is restored for normal DOS/VS operation. If KILL is specified, 
POWER/VS is cancelled immediately. 

POWER/VS acknowledges the PEND command with a message. 



PEND 



[uraddr 
KILL [,uraddr] 



Operands 

uraddr. Specifies the unit record device address of the printer on which the status report 
is to be printed. A dump is printed if KILL is specified. If uraddr is not specified, no 
status report or dump is produced, "uraddr" can be entered in either of two formats: 

cuu or X'cuu' 
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PCANCEL Command 



PFLUSH Command 



KILL. Terminates POWER/VS immediately for emergency reasons. Partitions supported 
by POWER/VS are also cancelled. 



Examples: 
PEND KILL,00E 
PEND 

PEND 00E 



Abnormal termination with system dump. 

Normal termination. No status report, no system 
dump. 

Normal termination with status report. No 
system dump. 



The PCANCEL command is used to cancel printing initiated by the PDISPLAY 
command. 

| PCANCEL j [STATUS] 



Operands 

STATUS. Terminates the printing initiated by the PDISPLAY command. A 
confirmation message is issued. This operand is optional. 



Example: 
PCANCEL 



Cancels printing initiated by PDISPLAY. 



The PFLUSH command is used to cancel the current job entry being created or processed 
by a POWER/VS task. 

When a read task is flushed, further input processing is terminated for this POWER/VS 
job, and an input entry is not built. 

When a write task is flushed, output processing is terminated for the current entry 
and the entry is deleted (if HOLD is not specified). The specified read/write task always 
remains active and continues by processing the next appropriate entry in the 
input/output queue. 

For a partition, the current DOS/VS job is canceled, and any other DOS/VS jobs in 
the same POWER/VS job are flushed. Also, the corresponding read entry is deleted 
(if HOLD is not specified). A list entry is created that contains a message to the pro- 
grammer stating that this job has been flushed by the operator. Processing continues with 
the next appropriate entry in the read queue. 



PFLUSH ) ( uraddr[,HOLD] 
F ) | partition [,HOLD] 



Operands 

uraddr. Specifies the unit record device address associated with the read/ write task. 
Its format is: 

cuu or X'cuu' 
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PRESTART Command 



HOLD. Specifies that the corresponding job entry is not to be deleted, but put in 
the hold state; that is, the input entry must not be deleted when a partition is flushed, 
or the output entry must not be deleted when a write task is flushed. If this parameter 
is specified when flushing a read task, it is ignored. 

The HOLD option is useful when a job needs more devices or other resources than 
are currently available; the job can then be rescheduled when the resources become 
available. Jobs requiring the same resources can be grouped together in input or output 
classes to prevent such inconvenience. 

partition. Specifies the partition in which the job to be flushed is executing as: 
BG, F4, F3, F2, or Fl 

Examples: 

PFLUSH 00E Delete list entry currently being printed. 

Continue with next entry. 

PFLUSH BG Terminate processing of current read entry for BG. 

Delete this entry. Continue with next entry. 

PFLUSH BG,HOLD Same as preceding example, except that the read 

entry is preserved and put in the hold state. 



The PRESTART command directs the specified list/punch task to stop and to resume 
printing/punching either from the beginning of the list/punch entry, or up to 9999 
pages (or cards) forward or backward from the point of interruption. 

The number of duplicate pages or cards written because of a PRESTART command is 
separately counted and stored in the list/punch account record. A page is defined as a 
skip-to-channel-one. 

If too large a backward count is specified, or if the operand is omitted, printing/punching 
resumes from the first page/card. If too large a forward count is specified, message 
1Q42I is issued. 

PRESTART I uraddr[,n] 

T \ 

Operands 

uraddr. Specifies the unit record device address associated with the write task. Its format 
is: 

cuu or X'cuu' 

n. Specifies a signed or unsigned value from to 9999. A plus sign indicates a forward 
count, a minus sign indicates a backward count from the last interrupted page/card. 
No sign indicates a count from the beginning. 

Example: 

PRESTART 00E,-10 Reprint the previous ten pages and continue to 

end of output. 



i 
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QUEUE MANAGEMENT COMMANDS 



"DISPLAY Command 



The PDISPLAY command provides the operator with a status report on SYSLOG of 
the job entry or entries specified by the operand. Each job entry is represented by 
one line containing the following items: 



Items 


Characters 


jobname 


8 


jobnumber 


5 


priority 


1 


disposition 


1 


class 


1 


"from" remote-id 


3 


"to" remote-id 


3 


number of records/pages 


6 


number of copies 


2 


forms-number 4 



The last four items are displayed for output only. For punch output, the number of 
records is displayed whereas for list output the number of pages is displayed. 

Each line of the status report starts with the message number 1R46I. If the status 
report is made up of entries from different queues, the name of the queue is printed 
before the first entry is displayed. 

The disposition of a job entry may appear as H for hold, K for keep, L for leave, 
D for delete (after processing), or as an * if an execution processor or a write task 
is currently processing the entry. 

The class can appear as an alphameric character from A to Z, or from to 4. 

Remote-id is displayed as a number from 000 to 200. The remote-id of the central loca- 
tion is 000. 

If a write task is processing a job entry when the PDISPLAY command is entered, 
"number of copies" is the number of copies left to be produced, including the one 
in progress. The "number Of records or pages" is the number of records or pages 
left to be produced. The operator can use this information to determine whether to 
stop a write task or let it continue until the current job entry is completed. 



i PDISPLAY) 



queuejobname [jobnumber] 
queue [,ALL] 
queue,HOLD 
queue,FREE 
queue,RJE [,remid] 
queue,LOCAL 
queue,*abc 
queue,class 
ALL[,listaddr] 
V HOLD 
FREE 

RJE[,remid] 
LOCAL 
*abc 
MSG 
A 
M 
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Operands 

queue. Specifies the queue for which the PDISPLAY command is to be executed: 

LST = the list queue 
PUN = the punch queue 
RDR = the read queue. 

jobname. Specifies the name by which the job entry is known to POWER/VS. Job- 
name can be two to eight alphametric characters. 

jobnumber. Specifies the number assigned to the job entry by POWER/VS. The job- 
number can be two to five digits. 

ALL. Specifies a request for the status of all job entries in the specified queue. If 
the queue parameter is not specified, status information on all entries in all queues 
is displayed on SYSLOG. 

listaddr. Specifies the printer to which the status report is to be sent. Its format is: 
cuu or X'cuu' 

HOLD. Specifies a request for the status of all entries in the specified queue that are 
not available for processing (i.e., disposition is H or L). If the queue parameter is not 
specified, status information is displayed on all such job entries. 

FREE. Specifies a request for the status of all entries in the specified queue that are 
available for processing, (i.e., disposition D or K). If the queue parameter is not specified 
status information is displayed on all such job entries. 

RJE. Specifies a request for the status of all RJE-type job entries in the specified queue. 
If the queue parameter is not specified, status information is displayed on all such job 
entries. 

RJE,remid. Specifies a request for the status of all job entries in the specified queue that 
are submitted by or routed to a specific remote user. If the queue parameter is not 
specified, status information is displayed on all such job entries. 

LOCAL. Specifies a request for the status of all job entries in the specified queue that 
are submitted from or routed to the central location. If the queue parameter is not 
specified, status information is displayed on all such job entries. 

class. Specifies a request for the status of all job entries in the queue with the specified 
class. Class can be specified as a character from A through Z, or from to 4 (input 
class only). 

*abc. Specifies a request for the status of all job entries having the first n characters 
of their jobnames in common, "abc" represents any combination of from one to seven 
alphameric characters. If the queue parameter is not specified, status information is 
displayed for all queues. The asterisk (*) must be keyed. 

MSG. Specifies a request to display all ALLUSERS-type messages that have been entered, 
together with their originators. The number displayed with each message can be used 
to delete that message. 

A. Specifies a request for a list of all active read/write tasks together with the job 
entries they are currently processing 

M. Specifies a request to re-display a list of all POWER/VS messages for which an 
operator reply is still required. 

Q. Specifies a request for the number of free queue records, free track groups, and 
free POWER/VS account records (if applicable). 



i 
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Examples: 



PALTER Command 



Display the status of all entries in all queues. 



AR 


POISPLAY ALL 
















Fl 


1R46I 


READER QUEUE 


P 





C 








***** 


Fl 


1R46I 


DISKDUMP 00C68 


9 


L 


A 








***** 


Fl 


1R46I 


PAUSE 00070 


9 


L 


A 








***** 


Fl 


1R46I 


DITTO 00071 


3 


L 


A 








***** 


Fl 


1R46I 


PRINTLOG 00069 


1 


L 


A 








***** 


Fl 


1R46I 


LIST QUEUE 


P 





C 


PAGES 


CC 


FORM 


***** 


Fl 


1R46I 


PAUSE 00070 


9 





A 


1 


1 




***** 


Fl 


1R46I 


PAYINPUT 00063 


3 





A 


3 


1 




***** 


Fl 


1R46I 


PAYEOIT 00064 


3 





A 


75 


1 




***** 


Fl 


1R46I 


PAYSORT 00065 


3 





A 


5 


1 




***** 


Fl 


1R46I 


PAYCAROS 00066 


3 





A 


7 


1 


CHEX 


***** 


Fl 


1R46I 


PAYLIST 00067 


3 





A 


44 


1 




***** 


Fl 


1R46I 


PRINTLOG 00069 


1 





A 


5 


1 




***** 


Fl 


1R46I 


PUNCH QUEUE 


P 





C 


CAROS 


CC 


FORM 


***** 


Fl 


1R46I 


PAYCARDS 00066 


3 





A 


233 


1 




***** 


Display the status of all jobs that 


begin with PAY. 








AR 


PCISPLAY *PAY 


















1R46I 


REAOER QUEUE NOTHING 


TO 01 SPLAY 




***** 




1R46I 


LIST QUEUE 


P 





C 


PAGES 


CC 


FCRM 


***** 




1R46I 


PAYINPUT 00063 


3 


D 


A 


3 


1 




***** 




1R46I 


PAYEOIT 00064 


3 





A 


75 


1 




***** 




1R46I 


PAYSORT 00C65 


3 





A 


5 


1 




***** 




1R46I 


PAYCAROS 00066 


3 





A 


7 


1 


CHEX 


***** 




1R46I 


PAYLIST 00067 


3 





A 


44 


1 




***** 




1R46I 


PUNCH QUEUE 


P 


D 


C 


CAROS 


CC 


FORM 


***** 




1R46I 


PAYCAROS 00066 


3 





A 


233 


1 




***** 




PRELEASE RORtPAUSE 


















1R88I 


OK 


















1Q47I 


BG PAUSE 00070 


FROM 000 








BG 


// JOB 


PAUSEJOB 

















The lines of the status report are not chained, and can, therefore, be interspersed with 
other DOS/VS messages. 



The PALTER command is used to change the various parameters of a job entry that 
is already queued. The operands are the same as those specified in the JOB, LST, and 
PUN statements, and they have the same format. Any number of parameters can be 
modified by one command. 

If an input entry (RDR) is specified and an .execution processor is currently processing 
this entry, message 1Q88I is issued. 

fhe priority attribute of a job entry in the input queue is identical to that of the 
corresponding entries in the output queues. On the other hand, the disposition and 
class attributes may be totally different in corresponding input and output job entries, 
since input disposition and class are defined in the JOB statement, whereas output 
disposition and class are defined in the LST and PUN statements. 

The COPY and REMOTE parameters apply to output only. When applied to an input 
entry, they are ignored. If an output entry is specified in the PALTER command and 
a write task is currently processing the entry, only the number-of-copies can be altered. 
(When output is segmented and the first segment has been deleted from the queue, 
"number-of-copies" cannot be altered.) If any other parameter is specified, message 
1Q88I is issued and the command is ignored. The same message is issued if the output 
is segmented and the first segment is already deleted from the output queue. 

PDISPLAY can be used to check the results of the PALTER command. 
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) PALTER j I jobname [jobnumber] 

A ( queue, j ALL 

.'■'■ ' , l*abe 
[JPRI=priority] 
[pDISP-disposition] 
[,CLASS=class] 
[,COPY=number-of-copies] 
[,REMOTE=remid] 



Operands 

queues Specifies the queue for which the command is to be executed: 

LST = the list queue 
. PUN = the punch queue 
M RDR = the read queue 

jobname. Specifies the name by which the job entry is known to POWER/VS. Jobname 
can be two to eight alphameric characters. 

jobnumber. Specifies the number assigned to the job entry by POWER/VS. The job- 
number may be one to five digits long. The PDISPLAY command may be used to obtain 
the correct specification for the jobnumber. This number can be used to identify differ- 
ent jobs with the same jobname. 

ALL. Requests that ALL entries in the specified queue are to be altered. 

*abc. Requests to alter all job entries that have the first"n" characters of their jobnames 
in common, "abc" represents any combination of from one to seven alphameric charac- 
ters. The asterisk (*) must be keyed. 

priority. Specifies the priority of the job entry. Priority is specified as a single digit 
from to 9. Nine is the highest priority. 

disposition. Can be specified as H for hold, K for keep, L for leave, or D for delete 
after processing. 

class. Can be specified as any alphabetic character from A though Z. Also, specifications 
from through 4 are allowed for input classes. 

remid. Can be specified as any number from to 200. "0" indicates the central location. 

Only the "to" remote-id can be modified with a PALTER command, the "from" 
remote-id cannot be modified. 

number-of-copies. Specifies the number of copies to be produced after the command 
is issued, including the one in progress. 

Examples: 

PALTER LST,PAYROLL,DISP=H,CLASS=B Alter the disposition of the output 

of job PAYROLL to H, and alter 
the class to B. 

A PUN,*PAYR,DISP=D Alter the dispositions of all jobs 

that begin with PAYR to D. 
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PDELETE Command 



PRE LEASE Command 



The PDELETE command is used to remove one or more job entries from the specified 
queue. Job entries being processed by an execution processor or write task are not 
affected by this command. 

( PDELETE ) ( queuejobname [jobnumber] 
L ( \ queue,ALL 

queue, class 
queue,*abc 
MSG[,n] 

Operands 

queue. Specifies the queue for which the command is to be executed: 

LST = the list queue 
PUN = the punch queue 
RDR = the read queue 

jobname. Specifies the name by which the job entry is known to POWER/VS. Jobname 
can be two to eight alphameric characters. 

jobnumber. Specifies the number assigned to the job entry by POWER/VS. The 
jobnumber is from one to five digits long. PDISPLAY can be used to obtain the 
jobnumber. 

ALL. All job entries are to be deleted from the specified queue. 

class. All job entries of a certain class are to be deleted from the specified queue. 

*abc. All job entries with the same first n characters are to be deleted, "abc" represents 
any combination of up to seven alphameric characters. 

MSG,n. ALLUSERS-type message number n is to be deleted. The actual message number 
can be obtained with a PDISPLAY MSG command. If n is omitted, all ALLUSERS-type 
messages issued by the central operator are deleted. 

Examples: 

PDELETE RDR,ALL Delete the entire read queue. 

PDELETE LST,B Delete all entries in the list queue with a 

class of B. 

PDELETE MSG Delete all ALLUSERS-type messages issued by the 

central operator. 



The PRELEASE command is used to take one or more job entries out of the hold 
or leave state and make them available for processing. After processing, a job entry 
originally in the leave state returns to the leave state; a job entry originally in the 
hold state is deleted from the queue. 

If a PRELEASE command is issued for a job entry that is not in the hold state or 
leave state, message 1Q88I is issued and the command is ignored. The same message 
is issued when the command is entered for a job entry that is to be printed or punched 
at a terminal. Such a job entry cannot be released by the central operator. 



( i>r>m tj a cc ) I queue jobname [jobnumber] 
) PRELEASE ( \ queue j jALL ] 

queue,class 
queue,*abc 



* 
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Operands 

queue. Specifies the queue for which the command is to be executed: 

LST = the list queue 
PUN = the punch queue 
RDR = the read queue 

jobname. Specifies the name by which the job entry is known to POWER/VS. Jobname 
may be two to eight alphameric characters. 

jobnumber. Specifies the number assigned to the job entry by POWER/VS. The 
jobnumber is one to five digits long. The PDISPLAY can be used to obtain the number. 

ALL. All job entries are to be released from the specified queue. 

class. All job entries of a certain class are to be released from the specified queue. 

*abc. All job entries with the same first n characters are to be released, "abc" represents 
any combination of up to seven alphameric characters. 

Examples: 

PRELEASE LSTJ?AYROLL Release the entry PAYROLL from the list queue. 
PRELEASE RDR,ALL Release the entire read queue. 

PRELEASE LST,*PAY Release all entries in the list queue whose names 

begin with P-A-Y. 



MISCELLANEOUS COMMANDS 
PINQUIRE Command 



The PINQUIRE command provides the central operator with a status report for a specific 
RJE line or for all lines. Line status can be: processing, inactive, not initiated, or not 
supported. 

• Processing. The remote user has entered a valid SIGNON command. In this case, 
the remote-id is displayed together with the line status. 

• Inactive. The line has been started by the central operator with a PSTART 
command, but no user is currently signed on. 

• Not initiated. The line has not been started by the central operator. 

• Not supported. During POWER/VS generation, no PLINE macro was specified for 
this line. 



( PINQUIRE \ \ lineaddr J 

\l , | ALL J 



Operands 

lineaddr. Specifies the line address associated with the RJE task. Its format is: 
cuu or X'cuu' 

ALL. The status of all supported lines are to be displayed. 

Example: 

PINQUIRE ALL Display the status of all supported lines. 

030 PROCESSING 022 

031 PROCESSING 150 

032 PROCESSING 004 

033 NOT INITIATED 

034 INACTIVE 



< 
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PBRDCST Command 



The PBRDCST command enables the central operator to communicate with remote 
users. Messages can be submitted for one specific user or for all users. 

Messages generated by the PBRDCST command are stored in virtual storage and dis- 
played only on request of the remote user. Up to 14 messages can be queued. 

Messages of the ALLUSERS-type are queued and given a message sequence number. The 
PDISPLAY command can be used to obtain the actual number. 



PBRDCST 
B 



remid/text' 



Operands 

remid. Specifies the remote-id to which the command applies. Remote users can be 
identified by numbers from 1 to 200. A specification of indicates the central location, 
and a specification of ALLUSERS indicated all users. 

'text'. Specifies the text of the message. The message can consist of from 1 to 40 
characters enclosed in single quotation marks. A single quotation mark within the 
message must be written as two quotation marks. 



Examples: 

PBRDCST 150,'RJE will be shut down in 30 min.' 



PBRDCST ALLUSERS/Service resumes at 8.00 a.m.' 



Broadcast the message 
to the user whose 
remote-id is 150. 

Broadcast the message 
to all users in the 
system. 



PACCOUNT Command 



The PACCOUNT command can be issued at any time to save the accumulated account 
file records. The operator is notified by a warning message when the account file becomes 
80% full. 

If any POWER/VS task requires an account record and there are no free records, a 
message is issued, and the task requesting the account record is placed in the wait 
state until the account file is emptied by the PACCOUNT command. After a message 
is issued stating "ACCOUNT FILE SAVED", the entire DASD space allocated to the 
file is available for more account records. 

It is the user's responsibility to process the accounting information. 



PACCOUNT 
J 



tapeaddr[,X'ss'] [,filename] 

DISK,filename 

DEL 



Operands 

If no operand is specified in the PACCOUNT command, the account file is spooled to 
disk. It is stored with priority 1 in output class P with DISP=H in the punch queue. In 
order to get the account information punched, the operator can start a punch write task 
on output class P. 
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PSETUP Command 



tapeaddr. Specifies the tape on which the file is to be written. Its format is: 

cuu or X'cuu' 

Optionally, the density and mode of the output tape can be specified in the format 
X'ss'. Before any record is written to the specified tape, label checking is performed. 

filename. If filename is specified along with tapeaddr, the file created will be a standard 
labeled tape file, "filename" is one to eight alphameric characters long. A standard 
label for the tape file must be present on the label cylinder. If a filename is not specified, 
the file will be a standard ^labeled DOS/VS tape file containing variable length records. 

DISK,filename. Specifies that the POWER/VS account file is to be written to disk, 
"filename" is one to eight alphameric characters long. 

It is the user's responsibility to store label information for a sequential disk output 
file on the label cylinder. The disk file created is a copy of the IJAFILE. The device 
type on which the receiving file resides must be the same as the device type on which 
IJAFILE resides. 

DEL. Specifies that the account file records are to be deleted. 

Examples: 

PACCOUNT 280 Save the account file on an unlabelled tape 

mounted on tape unit X'280'. 

PACCOUNT DEL Delete all account file records. 

PACCOUNT Spool account file records to punch queue. 



The PSETUP command can be entered only after message 1Q40A, requesting a special 
forms mount, is displayed. It causes n pages of spooled list data to be printed. All 
printable characters of the page are replaced by the character X. During the printing 
of the n pages, the operator can manually align the printer forms and can reissue PSETUP 
as many times as is necessary. 

The number of pages printed by PSETUP will be counted and stored separately in 
the list account record. 

When the PGO command is issued to resume printing, the pages are printed again with 
their original contents. 



PSETUP uraddr[,n] 

Operands 

uraddr. Specifies the unit record device associated with the write task. Its format is: 
cuu or X'cuu' 

n. One or two digits that specify the number of pages to be printed. If n is omitted, 
only one page is printed. 



< 
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Example: 
PSETUP 00E,2 
then, 
PGO 00E 



Print two pages to allow forms alignment. 



Pages are printed again with their original 
contents. Printing continues. 



XXXX XXX 



XX 



1st 
Page 



XXX XX XXX XXXXX XXXXXXXXXXXXXXX xxxxxxxx xxxxxxxxx 

XXX XXXXXXX XXXXXXXXXXXX XXX xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx xxxxxx xxxxxxx 



X XXXX 



XXXX XXX 



XX 



2nd 
Page 



XXX XX XXX XXXXX xxxxxxxxxxxxxxxxxxx xxxxxxxx xxxxxxxxx 

XXXX XXXXXXX XXXXXXXXXXX XXX xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx xxxxxx xxxxxxx 



X XXXX 



SEPT 30 t 74 



1st 

Page 



PAY TO THE ORDER OF ONE EMPLOYEE 



ONE HUNDRED TWENTY-THREE AND 



***123.45 
34/100 DOLLARS 



# 2001 



SEPT 30t 74 



2nd ' PAY T0 THE CRDER 0F ANOTHER EMPLOYEE 

Page t FIyE HUNCRED FORTY-THREE AND 



***543.21 
21/100 DOLLARS 



# 2002 
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POWER/VS REMOTE OPERATOR COMMAND LANGUAGE (ROCL) 



Remote job entry (RJE) is an extension of POWER/VS and allows the user to submit 
jobs from remote locations via IBM 2770, 2780 or 3780 terminals for processing under 
DOS/VS at a central installation. 

The central installation and the terminal can communicate through messages and 
commands. POWER/VS messages and responses to POWER/VS terminal commands are 
sent to the remote operator as list output. They are stored in virtual storage and auto- 
matically printed (and subsequently deleted) whenever the line is available for print 
operations. 

Broadcast messages are stored in virtual storage. They are displayed only upon request. 

The POWER/VS Remote Operator Command Language (ROCL) is used to control- jobs 
that are entered at a terminal for processing at a central installation. There are four 
types of commands: 

• Terminal control commands. Start and stop user sessions. 

• Task management commands. Apply to RJE write tasks. (The RJE read task is 
started by the central operator when he brings up the line, and its operation is 
controlled by the system, as are execution processors.) 

• Queue management commands. Apply to jobs that are submitted by or routed 
to the same remote-id as the one issuing the command. 

• Miscellaneous commands. Print page layouts or transmit messages. 
The following table includes all valid terminal commands. 



Type 


■ 
Command 


Function 


Terminal 
control 


* .. SIGNON 

* .. SIGNOFF 


start a user session 
terminate a user session 


Task 
management 


* .. START 

* .. STOP 

* .. GO 

* .. FLUSH 

* .. RESTART 


start a writer or start message 

generation 

stop a writer or stop message 

generation 

re-activate a write task 

flush an active job entry 

restart a writer 


Queue 
management 


* .. DISPLAY 

* .. ALTER 

* .. DELETE 

* .. RELEASE 


display job status 
alter job attributes 
delete a job or a message 
release a job 


Miscellaneous 


* .. BRDCST 

* .. SETUP 


transmit a message 
print page layout 



POWER/VS RJE terminal commands are entered on punched cards through the reader 
at the terminal. (See Figure 11.) They must be submitted outside POWER/VS job 
boundaries, otherwise they are treated as user data. 

Each RJE command consists of the following fields: 

1 Identification field. Contains an * in column 1, blank in column 2, and .. (periods) 
in columns 3 and 4. Column 5 must be blank. 

2 Operation field. Specifies the RJE command. At least one blank must separate 
this field from the following field. 

3 Operand field. Contains one or more parameters, separated by commas. At least 
one blank must separate the operand field and the comments field. 
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72 73-60 



o 











o 



o 



Figure 11. Format of RJE Commands 



Comments field. May contain any information considered helpful by the user. 
Continuation of the comments field is not allowed. 

The operation field, operand field, and comments field must be contained in 
columns 6 through 71. Column 72 must be blank. 

Sequence field. Sequence numbers are useful when a number of commands with 
the same operation code are submitted from a terminal. Columns 73 - 80 are 
returned in diagnostic messages. 



OPERATIONAL CHARACTERISTICS 



When the central operator starts a line, he starts, in fact, an RJE read task (reader). 

The first card submitted from the terminal must be a SIGNON command. This command 
identifies the terminal and attaches it logically to the system. 

After the SIGNON command has been successfully processed, the remote operator can 
submit any command or input data through the reader. Input data must start with 
a JECL or DOS/VS JOB card. 

Once a reader is started, it continues reading until EOF (end of file). Input records 
are grouped in blocks before they are transmitted over the line. 

Commands are removed from the input stream, and processed. Output that may result 
from these commands, like diagnostic messages and status reports, cannot immediately 
be returned to the terminal, since the line is still in read mode. Therefore, this type 
of output is temporarily queued. 

When EOF is encountered on the reader, the line is automatically turned around, and 
any POWER/VS messages are displayed on the printer. This is the only type of output 
that is produced spontaneously by the system. For normal job output a write task must 
explicitly be started by the terminal operator. 

After a writer is started, it normally prints or punches all available output of the selected 
class. The writer is then put in a dormant state, and the line is turned around, after 
which the reader is started again. After all input is read and the messages are printed, 
the writer can resume operation (if output has been stored in the meantime). If the 
operator does not want this Tito? writer facility, he may deactivate the writer with a 
STOP command. For example, a hot punch writer could be undesirable when the same 
hopper is used for both read and punch operations. 

When no more input or output is left to be processed, or when operator intervention 
is required on the reader, printer, or punch, the audible alarm sounds on the terminal, 
and POWER/VS expects either a ready interrupt from the reader or for more output to 
be stored in the output queues (hot writer). The terminal is signed off by POWER/VS 
after n minutes of idle time, where n is the value defined during POWER/VS generation 
through the TIMEOUT generation parameter. (If TIMEOUT=NO, sign off is not forced). 



< 
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TERMINAL COMMANDS 



SIGNON Command 



SIGNOFF Command 



When a writer is interrupted (I/O error, for example), the operator can enter a FLUSH, 
a RESTART, or a STOP command through the reader. 

Note. If a punch writer and a list writer are active at the same time, list output receives 
priority over punch output. 



The SIGNON command identifies the terminal, and makes the logical connection 
between the terminal and the system. It must be the first card submitted from the 
terminal after the line is started by the central operator. It can also be submitted during 
the course of the session, in which case it terminates the current session and initiates 
the next session. 

The operator must use the remote-id assigned to him during POWER/VS generation, 
since the terminal characteristics are defined in relation to this remote-id. If the same 
remote-id is used to sign onto another terminal with different hardware characteristics, 
causing unpredictable results. 

The security password must match the password set for the line by the central operator. 
If the central operator did not specify a password when the line was started, it must 
match the password set for the line during POWER/VS generation. If no password is 
set for the line, the password parameter can be omitted. 

* .. SIGNON remid[, password] user information 

Operands 

remid. Specifies the remote-id assigned to the terminal during POWER/VS generation. 
Remote users are identified by numbers from 1 to 200. 

password. Specifies the password set for the line by the central operator, or set during 
POWER/VS generation. It can be any combination of up to eight alphameric characters. 

user information. Consists of up to sixteen bytes of user information, which are moved 
to the line account record. This information is punched in 'columns 56 to 71. 

Note. An invalid SIGNON command is interpreted as a SIGNOFF command. The 
terminal is disconnected if it is on a switched line. 



Example: 
* .. SIGNON 



002, SECRET Sign on at. a terminal with remote-id 002 

and password SECRET. 



The SIGNOFF command informs the system that the remote operator will terminate 
the session at the next end-of-file condition on the reader. POWER/VS will disconnect 
the terminal from the system, stop any active writers, and prepare the line for other 
terminals to sign on. 

Note. A terminal is forced to sign off when it has been idle for a number of minutes, 
as defined during POWER/VS generation. 

* .. SIGNOFF (no operand) 



Example: 

* .. SIGNOFF 



Terminate a session. 
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TASK MANAGEMENT COMMANDS 



START Command 



The START command is used to initiate an RJE write task (writer). The RJE read 
task (reader), is controlled only by the central operator. 

The remote operator must enter a START command in order to receive his output. 
POWER/VS does not send unsolicited output to any terminal. 

A START command is invalid when applied to an active task. 

The START command is also used to cause broadcast messages to be accepted. (When an 
RJE task is started, the terminal accepts broadcast messages until MSG is specified in the 
STOP command.) 



* .. START 



task 

task,class 

MSG 



Operands 

task. Specifies the task to be started as LST or PUN. Write entries are processed on 
a flrst-in, first-out basis within priority, within class. 

class. Defines the output class(es) upon which the task is to operate. Up to four classes 
can be designated by specifying one to four alphabetic characters from A through Z. 
The order specified is the order in which the classes will be processed. If no class 
parameter is specified, only class A is selected. 

MSG. Specifies that all subsequent broadcast messages directed to this terminal are to 
be accepted (printed). 



Examples: 

* .. START PUN 

* .. START LST,AB 



Start punch task for class A. 
Start list task for classes A and B. 



STOP Command 



The STOP command is used to terminate an RJE write task. The terminal operator 
cannot control the operation of an RJE read task. 

A STOP command is invalid when applied to an inactive task. 

The STOP command is also used to cause broadcast messages to be ignored (not 
accepted). 



* .. STOP 



task 

task,EOJ 
task,RESTART 
MSG 



( 
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Operands 

task. Specifies the task to be stopped. LST or PUN are the valid entries. 

EOJ. Specifies that the task will not stop until it has completed processing the current 
entry. 

RESTART. Specifies that when the task is started again, processing will begin at the 
record following the last one processed before the STOP command was issued. 

MSG. Specifies that all subsequent broadcast messages directed to this terminal are to be 
ignored. In addition, existing messages in the queue are deleted immediately. 

Note. // either EOJ or RESTART is not specified along with "task", processing will 
begin at the first record of the current job entry when this task is started again (via 
START). 



Examples: 

* .. STOP PUN,RESTART 

* .. STOP LST,EOJ 

* .. STOP LST 

* .. STOP MSG 



Stop the punch task. When the task is 
restarted, processing of the entry continues 
at the point of interruption. 

Stop the list task after completion of the 
current list entry. 

Stop the Jist task immediately. When the 
task is restarted, processing will start at 
the beginning of the interrupted list entry. 

Ignore broadcast messages. 



GO Command 



The GO command is used to re-activate a write task after receiving the "mount forms" 
message. 



* .. GO task 

Operands 

task. Specifies the task to be re-activated as LST or PUN. 



Example: 
* .. GO LST 



Re-activate the Hst task. The proper forms 
have been mounted. 



FLUSH Command 



The FLUSH command is used to discontinue the job entry currently being processed 
by an RJE write task. 

When the write task is flushed, further output processing is terminated for this 
POWER/VS job, and the write entry is deleted, unless HOLD is specified. 

FLUSH is invalid when applied to an inactive task. Also, FLUSH can only be issued 
for a task that has been interrupted by the remote or central operator or by an action- 
type POWER/VS message. 



* .. FLUSH 



/task \ 

\task,HOLDJ 
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RESTART Command 



Operands 

task. Specifies the task to be deleted as LST or PUN. 

HOLD. Specifies that the corresponding write entry is not to be deleted, but put in 
the hold state. 

Examples: 

* .. FLUSH PUN Delete the punch entry currently being punched. 

Continue with the next entry. 

* .. FLUSH LST,HOLD Skip the list entry currently being printed, 

but do not delete it from the queue. 
Continue with the next entry. 



The RESTART command directs the RJE write task to discontinue printing or punchm b 
immediately and to resume output from a specified point. A list writer can resume 
printing from either the beginning of the list entry, or up to 9999 pages forward or 
backward from the interrupted page. A punch writer can resume punching from either 
the beginning of the punch entry, or up to 9999 cards forward or backward. 

The number of duplicated pages printed or cards punched because of a RESTART 
command is separately counted and stored in the list account record (if created). 

RESTART is invalid when applied to an inactive task. Also, RESTART is only applicable 
to a task that has been interrupted by the operator or by an action-type POWER/VS 
message. 



* .. RESTART (task. \ 

\ task,nj 

Operands 

task. Specifies the task to be restarted as LST or PUN. 

n. Specifies a signed or unsigned value from to 9999. A plus sign indicates the number 
of pages or cards forward and a minus sign indicates the number of pages or cards 
backward from the last interrupted page or card. No sign indicates a specified page 
or card count from the beginning. 

If the operand is omitted or is too large a backward count, output resumes from the 
first page or card. If too large a forward count is specified , message 1Q42I is issued and 
the command is ignored. 

Example: 

* .. RESTART LST ,-10 Reprint the previous ten pages and continue 

to the end of output. 



QUEUE MANAGEMENT COMMANDS 
DISPLAY Command 



The DISPLAY command provides the remote operator with a status report of the 
specified job entry or entries. The remote operator can only display the status of jobs 
that he submitted himself ">r that have been routed to him. 



( 



7.6 DOS/VS POWER/VS Installation and Operations 



Each job entry is represented by one line containing the following items: 



Items 


Characters | 


jobname 


8 


jobnumber 


5 


priority 


1 


disposition 


1 


class 


1 


FROM remote- id 


3 


TO remote-id 


3 


number of records (pages) 


6 


1 number of copies 


2 


1 forms-number 


4 



The last four items are displayed for output only. For punch output, the number of 
records is displayed, whereas for list output the number of pages is displayed. 

Each line of the status report starts with the message number 1R46I. If the status 
report is made up of entries from different queues, the name of the queue is printed 
before the first job entry is displayed. 

The disposition of a job entry may appear as H for hold, K for keep, L for leave, 
D for delete (after processing) or as an * if an execution processor or a write task 
is currently processing the entry. 

The class can appear as an alphameric character from A to Z, or from to 4. Remote-id 
is displayed as a number from 001 to 200 if the job is entered from a terminal or 
if the output is routed to a terminal. The remote-id of the central location (000) is not 
printed in the status report. 

If a write task is processing a entry when the DISPLAY command is entered, "number 
of copies" is the number of copies left to be produced, including the one in progress. 
The "number of records or pages" is the number of records or pages left to be produced. 
The operator can use this information to determine whether to stop a write task or 
let it continue until the current entry is completed. 

Output from the DISPLAY command is stored in virtual storage, and is transmitted 
as soon as the line becomes available for write operations. 



* .. DISPLAY 



f queuejobname[, jobnumber] *\ 
queue [,ALL] 
queue,HOLD 
queue,FREE 
queue,*abc 
queue,class 
ALL 
HOLD 
FREE 
*abc 
MSG 



Operands 

queue. Specifies the queue for which the DISPLAY command is to be executed: 

LST = the list queue 
PUN = the punch queue 
RDR = the read queue 
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jobname. Specifies the name by which the job entry is known to POWER/VS. Jobname 
can be two to eight alphameric characters. 

jobnumber. Specifies the number assigned to the job entry by POWER/VS. The 
jobnumber is one to five digits long. 

ALL. Requests the status of all entries in the specified queue. If the queue parameter 
is not specified, status information on all entries in all queues is displayed. 

HOLD. Requests the status of all entries in the specified queue that are not available 
for processing (that is, in hold state or leave state). If the queue parameter is not 
specified, status information is displayed on all such entries. 

FREE. Requests the status of all entries in the specified queue that are available for 
processing (that is, in keep state or dispatchable state). If the queue parameter is not 
specified, status information is displayed on all such entries. 

class. Requests the status of all job entries in the queue with the specified class. Class 
can be specified as an alphameric character from A through Z, or from to 4. 

For a more detailed discussion of class, refer to "POWER/VS Concepts and Facilities". 

*abc. Requests the status of all entries having the first n characters of their jobnames 
in common, "abc" represents any combination of from one to seven characters. If the 
queue parameter is not specified, status information is displayed for all queues. 

MSG. Requests the display of all ALLUSERS-type messages that have been entered, 
together with their originators and all operator messages routed specifically to this 
remote-id. Operator messages are automatically deleted when they are displayed. 



Examples: 

* .. DISPLAY RDR,*PAY 



Display the status of all entries for remote-id 
015 that are in the read queue and that begin 
with PAY. 



READER QUEUE NOTHING TO DISPLAY 

PAGES CC FCRM 
3 1 



Fl 1R46I 

Fl 1R46I LIST QUEUE POC 

Fl 1R46I PAYINPUT 00063 3 D A 

Fl 1R46I PAYEOIT 00064 3 A 

Fl 1R46I PAYSORT 00C65 3 A 

Fl 1R46I PAYCAROS 00066 3 A 

Fl 1R46I PAYLIST 00067 3 A 

Fl 1R46I PUNCH QUEUE POC 

Fl 1R46I PAYCAROS C0066 3 D A 



75 
5 

7 
44 



CHEX 



CARDS CC FORM 
233 1 



***** 
***** 
***** 
***** 
***** 
***** 
***** 
***** 
***** 



* .. DISPLAY ALL 



Display the status of all entries in all queues. 



Fl 1R46I REA0ER QUEUE POC 

Fl 1R46I OISKOUMP 00068 9 L A 

Fl 1R46I PAUSE 00070 9 L A 

Fl 1R46I DITTO 00071 3 L A 

Fl 1R46I PRINTLOG 00069 1 L A 

Fl 1R46I LIST QUEUE POC 

Fl 1R46I PAUSE C007O 9 A 

Fl 1R46I PAYINPUT 00063 3 A 

Fl 1R46I PAYEOIT 00064 3 A 

Fl 1R46I PAYSORT 00065 3 A 

Fl 1R46I PAYCAROS 00066 3 A 

Fl 1R46I PAYLIST 00067 3 A 

Fl 1R46I PRINTLOG 00069 1 A 

Fl 1R46I PUNCH QUEUE POC 

Fl 1R46I PAYCAROS 00066 3 A 



PAGES CC FORM 

1 1 

3 1 

75 1 

5 1 

7 1 CHEX 
44 1 
5 1 
CAROS CC FGRH 
233 1 



***** 
***** 
***** 
***** 
***** 
***** 
***** 
***** 
***** 
***** 
***** 
***** 
***** 
***** 
***** 



( 
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ALTER Command 



The ALTER command is used to change the various parameters of a job entry after 
it has been logged in POWER/ VS. The operands are the same as those specified in 
the JOB, LST, and PUN statements and have the same format. Any number of parameters 
can be modified by one command. However, the remote user can alter attributes of 
only those jobs that were submitted by himself or were routed to him. 

If an input queue entry is specified and an execution processor is currently processing 
this entry, message 1R88I is issued. 

The priority attribute of an entry in the read queue is identical to that of the 
corresponding entries in the write queues. On the other hand, the disposition and class 
attributes may be totally different in corresponding read and list/punch entries,, since 
input disposition and class are defined in the JOB statement, whereas output disposition 
and class are defined in the LST and PUN statements. 

The COPY and REMOTE parameters apply to the output only. When applied to a 
read entry, they are ignored. If a write entry is specified in the ALTER command 
and a write task is currently processing the entry, only the number-of-copies can be 
altered, ("number-of-copies" cannot be altered if an entry is segemented and the first 
segment has been deleted from the queue.) If any other parameter is specified, message 
1R31I is issued and the command is ignored. The same message is issued if the output 
is segmented and the first segment is already deleted from the output queue. 

No confirmative message is issued after the ALTER command. DISPLAY can be used 
for verification. 



{jobname r,jobnumber] 
* .. ALTER queue ^ ALL 

f *abc 



[,PRI=priority] 

[,DISP=disposition] 

[,CLASS=class] 

[,COPY=number-of-copies] 

[,REMOTE=remid] 



Operands 

queue. Specifies the queue for which the command is to be executed: 

LST = the list queue 
PUN = the punch queue 
RDR = the read queue 

jobname. Specifies the name by which the job entry is known to POWER/ VS. Jobname 
can be two to eight alphameric characters. 

jobnumber. Specifies the number assigned to the job entry by POWER/VS. The 
jobnumber may be one to five digits long. The DISPLAY command may be used to 
obtain the jobnumber. 

priority. Specifies the priority of the job entry. Priority is specified as a single digit 
from to 9. Nine is the highest priority. 

disposition. Can be specified as H for hold, K for keep, L for leave, or D for delete 
(after processing). 

class. Can be specified as any alphabetic character from A through Z. Also, specifications 
from through 4 are allowed for input classes. 
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DELETE Command 



remid. Can be specified as any number from to 200. "0" indicates the central location. 

Only the "to" remote-id can be modified with an ALTER command; the "from" 
remote-id cannot be modified. 

number-of-copies. Specifies the number of copies to be produced after the command 
is issued, including the one in progress. 

Example: 

* .. ALTER LSTJPAYROLL,DISP=D,CLASS=B 

Alter the disposition of the output 
of job PAYROLL to D, and alter "the 
class to B. 



The DELETE command is used to remove one or more job entries from the specified 
queue. Job entries being processed by an execution processor or write task are not 
affected by this command. The remote user can delete only jobs or messages that were 
submitted by himself or were routed to him. 

* .. DELETE | queuejobname [jobnumber] 
queue, ALL 
queue, class 
queue,*abc 
MSG[,n] 



Operands 

queue. Specifies the queue for which the command is to be executed: 

LST = the list queue 
PUN = the punch queue 
RDR = the read queue 

jobname. Specifies the name by which the job entry is known to POWER/VS. Jobname 
can be two to eight alphameric characters. 

jobnumber. Specifies the number assigned to the job entry by POWER/VS. The 
jobnumber is from one to five digits long. The DISPLAY command can be used to 
obtain the jobnumber. 

ALL. All job entries are to be deleted from the specified queue. 

class. All job entries of a certain class are to be deleted from the specified queue. 

*abc. All job entries with the same first n characters are to be deleted. "abc M represents 
any combination of up to seven alphameric characters. 

MSG41. ALLUSERS-type message is to be deleted, where "n" is the message number. 
The message number can be obtained with a DISPLAY MSG command. If n is omitted, 
all ALLUSERS-type messages that were entered from this remote-id are deleted. 

Examples: 

* .. DELETE RDR,ALL Delete the entire read queue. 

* .. DELETE LST,B Delete all entries in the list queue with a 

class of B. 

* .. DELETE MSG Delete all ALLUSERS-type messages entered by 

this remote-id. 
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RELEASE Command 



The RELEASE command is used to take one or more job entries out of the hold 
or leave state and make them available for processing. After processing, a job entry 
originally in the leave state returns to the leave state; a job in the hold state is deleted 
from the queue. 

If a RELEASE command is issued for a job entry that is not in the hold state or 
leave state, a message is issued and the command is ignored. 

The remote user can release only those jobs that were submitted by himself or were 
routed to him. 



* .. RELEASE 



queuejobname [jobnumber] 
queue [, ALL] 
queue, class 
queue, *abc 



Operands 

queue. Specifies the queue for wnich the command is to be executed: 

LST = the list queue 
PUN = the punch queue 
RDR = the read queue 

jobname. Specifies the name by which the job entry is known to POWER/VS. Jobname 
can be two to eight alphameric characters. 

jobnumber. Specifies the number assigned to the job entry by POWER/VS. The 
jobnumber is one to five digits long. The DISPLAY command can be used to obtain 
the number. 

All. All job entries are to be released from the specified queue. 

class. All job entries of a certain class are to be released from the specified queue. 

*abc. All job entries with the same first n characters are to be released, "abc" represents 
any combination of up to seven alphameric characters. 

Examples: 

* .. RELEASE LST,PAYROLL Release the entry "PAYROLL" from list queue. 

* .. RELEASE RDR,ALL Release the entire read queue. 

* .. RELEASE LST,*PAY Release all entries in the list queue that begin 

with PAY. 
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MISCELLANEOUS COMMANDS 



BRDCST Command 



SETUP Command 



The BRDCST command enables the remote operator to communicate with the central 
operator and other remote users. Messages can be submitted for one specific user or 
for all users. 

Messages generated by the BRDCST command for specific remote-ids are stored in the 
list queue and displayed only on request. 

Messages of the ALLUSERS-type are queued and given a message sequence number. 
The DISPLAY MSG command can be used to obtain the actual number. 



* .. BRDCST remid/text* 



Operands 

remid. Specifies the remote-id to which the command applies. Remote users can be 
identified by numbers from 1 to 200. A specification of indicates the central location, 
and a specification of ALLUSERS indicates all users. 

'text'. Specifies the text of the message. The message can consist of from 1 to 40 
characters enclosed in single quotation marks. A single quotation mark within the 
message must be written as two quotation marks. 



Examples: 

* .. BRDCST 150,'Payroll will be completed in 30 min.' 

Broadcast the message to the user whose 
remote-id is 150. 

* .. BRDCST 0,'lnventory is finished' 

Broadcast the message to the central operator. 



The SETUP command can be entered only atter a message requesting a special forms 
mount is displayed. It causes n pages of spooled list data to be printed. All printable 
characters of the page are replaced by the character X. During the printing of the n pages, 
the operator can manually align the printer forms. 

The number of pages printed by SETUP are counted and stored separately in the list 
account record. 

When the RESTART command is issued to resume printing, the pages are printed again 
with their original contents. 



* .. SETUP 



N 



n. One or two digits that specify the number of pages to be printed. If n is omitted, 
only one page is printed. 
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Example: 



SETUP 2 



Print two pages to allow forms alignment. 



XXXX XXX XX 



1st 

Page 



XXX XX XXX XXXXX XXXXXXXXXXXXXXX XXXXXXXX xxxxxxxxx 

XXX xxxxxxx xxxxxxxxxxxx xxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx xxxxxx xxxxxxx 



X XXXX 



XXXX xxx 



XX 



2nd 
Page 



XXX XX XXX XXXXX XXXXXXXXXXXXXXXXXXX XXXXXXXX xxxxxxxxx 

XXXX xxxxxxx xxxxxxxxxxx xxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx xxxxxx xxxxxxx 



X XXXX 



*..GO LST 



Pages are printed again with their original 
contents. Printing continues. 



SEPT 30 t 74 



PAY TO THE ORDER OF ONE EMPLOYEE 



1st 
Page 



ONE HUNDRED TWENTY-THREE AND 



***123.45 
34/100 DOLLARS 



# 2001 



SEPT 30, 74 



PAY TO THE CRDER OF ANOTHER EMPLOYEE 



2nd 
Page 



FIVE HUNCRED FORTY-THREE AND 



***543.21 
21/100 DOLLARS 



* 2002 
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APPENDIX A-ACCOUNT RECORDS 



The following tables describe the contents of the record types that make up the account 
file. (See "Account File" in "POWER/VS Concepts and Facilities".) The last column, 
column F, indicates the format of each field in the record: 

a = alphameric 

b = binary 

p = packed decimal 

If JECL is not used to delimit POWER/VS jobs, the jobname and user information 
placed in the account records are taken from the // JOB statement. 



READ ACCOUNT RECORD 



A read account record is created for each read entry. Whether or not the entry has 
actually been placed in the queue file is indicated by the POWER/VS cancel code. 

The read account record is written to the POWER/VS account file after the correspond- 
ing read entry is processed by the read task. 

Read account records are not created for a writer-only partition. 



Bytes 


Name 


Description 


F 


00-07 


ARDY 


Date, in format specified in DOS/VS SYSGEN 
(mm/dd/yy or dd/mm/yy) 


a 


08-11 


ARST 


Start time of read (0HHMMSSF; F=sign) 


P 


I2-I5 


ARET 


Stop time or read (0HHMMSSF; F=sign) 


P 


16-31 


ARUI 


16 bytes of user information from * $$ JOB 
or // JOB card 


a 


32-39 


ARNM 


POWER/VS jobname from * $$ JOB or // JOB card 


a 


40-41 


ARNO 


Jobnumber assigned by POWER/VS 


b 


42 


ARRI 


Record identifier (R) 


a 


43 


ARCN 


POWER/VS cancel code (See Appendix B) 


b 


44 




Reserved 




45-47 


ARCU 


Reader device address 


b 


48 


ARFJ 


"From" remote-id 


b 


49 


ARTJ 


"To" remote-id (note D 


b 


50 


ARCL 


Input class 


a 


51 


ARPY 


Input priority number 


a 


52-55 


ARNR 


Number of records read (note 2) 


b 


56-57 


ARNT 


Number of tracks for input storage 


b 



Notes 

1. The "to" remote-id is a dummy entry in the read account record. It is copied from the "from" 
remote-id. 

2. The number of records read includes the number of records added or deleted through the 
RDREXIT routine. 
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LIST ACCOUNT RECORD 



A list account record is created for each list entry created by the execution list task. 

A list account record is written to the POWER/VS account file after the list entry 
is printed. 



Bytes 


Name 


Description 


F 


00-07 


ALDY 


Date/in format specified in DOS/VS SYSGEN 
(mm/dd/yy or dd/mm/yy) 


a 


08-11 


ALST 


Start time of list (0HHMMSSF; F=sign) 


P 


12-15 


ALET 


Stop time of list (0HHMMSSF; F=sign) 


P 


16-31 


ALUI 


16 bytes of user information from * $$ JOB 
or // JOB card 


a 


32-39 


ALNM 


POWER/VS jobname from *'$$ JOB card or 
// JOB card 


a 


40-41 


ALNO 


Jobnumber assigned by POWER/VS 


b 


42 


ALRI 


Record identifier (L) 


a 


43 


ALCN 


POWER/VS cancel code (See Appendix B) 


b 


44 




Reserved 




45-47 


ALCU 


Printer device address 


b 


48 


ALFJ 


"From" remote-id 


b 


49 


ALTJ 


"To" remote-id 


b 


50 


ALCL 


Printed output class 


a 


51 


ALPY 


Printed output priority number 


a 


52-55 


ALNR 


Number of lines printed 


b 


56-57 


ALNT 


Number of tracks for output storage (note 2) 


b 


58 


ALSN 


Job subnumber assigned by POWER/VS (note 3) 


b 


59 


ALNC 


Number of printed copies (note 4) 


b 


60-63 


ALFI 


Printed forms identification 


a 


64-67 


ALNA 


Number of extra records printed due to 
PRESTART, PSETUP, or JSEP 


b 


68-69 


ALNP 


Number of pages printed (skips to channel 1) 


b 


70-71 


ALNE 


Number of extra pages printed due to 
PRESTART, PSETUP, or JSEP 


b 



Notes. 

1. 

2. 



If present, the user information is copied into each list entry generated for the job. 

Only for spooling to disk; when spooling to tape, this field is zero. 

For each list entry within a POWER/VS job, a separate list account record is created with 
a unique job subnumber. 



4. Total for all copies of that segment. 
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PUNCH ACCOUNT RECORD 



A punch account record is created for each punch entry created by the execution punch 
task. 

A punch account record is written to the POWER/ VS account file after the punch 
entry is punched. 



Bytes 


Name 


Description 


F 


00-07 


APDY 


' Date, in format specified in DOS/VS SYSGEN 
(mm/dd/yy or dd/mm/yy) 


a 


08-11 


APST 


Start time of punch (0HHMMSSF; F=sign) 


P 


12-15 


APET 


Stop time of punch, (0HHMMSSF; F=sign) 


P 


16-31 


APUI 


16 bytes of user information from * $$ JOB 
or // JOB card 


a 


32-39 


APNM 


POWER/VS jobname from * $$ JOB card 
or // JOB card 


a 


40-41 


APNO 


Jobnumber assigned by POWER/VS 


b 


42 


APR I 


Record identifier (P) 


a 


43 


APCN 


POWER/VS cancel code (See Appendix B) 


b 


44 


APRJ 


Reserved 


b 


45-47 


APCU 


Punch device address 


b 


48 


APFJ 


"From" remote-id 


b 


49 


APTJ 


"To" remote-id 


b 


50 


APCL 


Punched output class 


a 


51 


APPY 


Punched output priority number 


a 


52-55 


APNR 


Number of records punched 


b 


56-57 


APNT 


Number of tracks for output storage (note 2) 


b 


58 


APSN 


Job subnumber assigned by POWER/VS (note 3) 


b 


59 


APNC 


Number of punched copies (note 4) 


b 


60-63 


APFI 


Punch forms identification 


a 


64-67 


APNA 


Number of extra cards punched due to 
PRESTART or JSEP 


b 



Notes. 

1. If present, the user information is copied into each punch entry generated for the job. 

2. Only for spooling to disk; when spooling to tape this field is zero. 

3. For each punch entry within a POWER/VS job, a separate punch account record is created 
with a unique job subnumber. 

4. Total for all copies of that segment. 



EXECUTION ACCOUNT RECORD 



One execution account record per DOS/VS job step is constructed. It contains informa- 
tion passed to the account file by the DOS/VS job accounting interface, plus informa- 
tion produced by the POWER/VS accounting routine. If the job or job step is canceled 
before completion, statistics reflect processing up to that time. 
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Bytes 


Name 


Description 


F 


00-07 


AEDY 


Date, in format specified in DOS/VS SYSG EN 


a 


08-11 


AEST 


Start time of job step (0HHMMSSF; F=sign) 


P 


12-15 


AEET 


Stop time of job step (0HHMMSSF; F=sign) 


P 


16-31 


AEUI 


16 bytes of user information from * $$ JOB card 


a 


32-39 


AENM 


POWER/VS jobname or "AUTONAME" 


a 


40-41 


AENO 


Jobnumber assigned by POWER/VS 


b 


42 


AERI 


Record identifier (E) 


a 


43 


AECN 


POWER/VS cancel code (See Appendix B) 


b 


44 




Reserved 




45-47 




Reserved 




48 


AEFJ 


"From" remote-id 


b 


49 


AETJ 


"To" remote-id (note 1 ) 


b 


50 


AECL 


Class 


a 


51 


AEPY 


Priority 


b 


52-55 




Number of lines spooled 


b 


5Q-59 




Number of cards spooled 


b 


60-61 




Number of pages spooled 


b 


62-63 




Length of DOS/VS SI accounting table 


b 


64-65 




Length of total account record 


b 


66-71 




Reserved 




72-79 




DOS/VS jobname from //JOB card 


a 


80-95 




16 bytes of user information from // JOB card 


a 


96-97 




Partition-id in EBCDIC format 


a 


98 




DOS/VS cancel code 


b 


99 




Type of record; S = job step, L = last step 


a 


100-103 




Reserved 




104-111 




Phase name, taken from execute card 


a 


112-115 




End address of active program phase, from COM REG 




116-119 




CPU time elapsed in a job step, counted in 
300ths of a second 


b 


120-123 




Overhead time (in 300ths of a second); system 
overhead time divided among running partitions 


b 


124-127 




All-bound time (in 300ths of a second); system 
wait state time divided among running partitions 


b 


128- 




SIO tables; 6 bytes for each device specified 
at system generation, as follows: 2 bytes for 
device address (Ocuu), 4 bytes for count of 
SIOs in current job step (note 2) 


b 






Overflow byte; normally X'20', but X'30' if 


b 






more devices are used within a partition than 








specified at DOS/VS system generation 








User accounting information (note 3) 













Notes. 

1. The "to" remote-id is a dummy entry in the execution account record; it is copied from the 
"from" remote-id. 

2. POWER/VS updates the SIO tables in the execution account record with the number of start 
I/Os it intercepted. 

3. Appendix F explains how to add user account information to an execution account record 
through a user-written routine ($JOBACCT). * 
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LINE ACCOUNT RECORD 



A line account record is written when each RJE user session is terminated. The SIGNOFF 
code indicates whether the session was normally or abnormally terminated. 



Bytes 


Name 


Description 


F 


00-07 


ATDY 


Date, in format specified in DOS/VS SYSGEN 
(mm/dd/yy) or (dd/mm/yy) 


a 


08-11 


ATST 


SIGNON time (0HHMMSSF; F=sign) 


P 


12-15 


ATET 


SIGNOFF time (0HHMMSSF; F=sign) 


P 


16-31 


ATUI 


16 bytes of user information from the 
signon command 


a 


32-39 


ATNM 


Line password 


a 


40-41 




Reserved 




42 


ATRI 


Record identifier (T) 


a 


43 


ATCN 


SIGNOFF code (See Appendix C) 


b 


44 


ATEJ 


Remote identifier 


b 


45-47 


ATCU 


Line address 


b 
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APPENDIX B-POWER/VS CANCEL CODES 



Cancel Code 


Condition 


X'lO' 
X'30' 
X'40* 
X'60' 
X'70' 


Normal end of POWER/VS job or task (note 1) 
PSTOP has been issued (note 2) 
PFLUSH has been issued 

POWER/VS job has been flushed via RDREXIT 
cancelled due to I/O error 



Notes 

1 



Although no abnormal POWER/VS termination occurred, the DOS/VS jobs associated with 
the job entry could have been canceled via DOS/VS. 

The PSTOP cancel code is not stored in an account record if the EOJ option was specified 
in the PSTOP command. 



Appendix B - POWER/VS Cancel Codes 9. 1 



APPENDIX C-RJE SIGNOFF CODES 



SIGNOFF Code 


Condition 


X'01' 
X'02' 

XW 
X'08' 


SIGNON/SIGNOFF card read 
Line stopped by central operator 

SIGNOFF forced because idle time limit exceeded 
SIGNOFF forced because of irrecoverable I/O error 
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APPENDIX D-STATUS REPORT FORMAT 



FILE STATISTICS 



POWER/VS STATUS REPORT 



08/06/74 



01/17/43 



QUEUE FILE 



IJQFILE 



TOTAL NUMBER OF QUEUE RECORDS 

NUMBER OF FREE QUEUE RECORDS 

MAXIMUM NUMBER OF QUEUE RECORDS USED IN PRESENT SESSION 



618 RECORDS 

604 RECORDS 

14 RECOROS 



DATA FILE 



IJDFILE 



TOTAL NUMBER OF TRACKS 
TRACK GROUP SIZE 
DATA BLOCK SIZE 



1236 TRACKS 
2 TRACKS 
516 BYTES 



ACCOUNT FILE IJAFILE 

TOTAL NUMBER OF TRACKS 
PERCENTAGE OF FILE THAT IS FILLED 



60 TRACKS 
4 % 



REAL STORAGE ALLOCATED TO POWER/VS PARTITION 
NUMBER OF TIMES TASKS WERE WAITING FOR REAL STORAGE 
MAXIMUM NUMBER OF REAL PAGES FIXED 
MAXIMUM NUMBER OF TASKS ACTIVE AT ONE POINT IN TIKE 



11 PAGES 

TIMES 

5 PAGES 

2 TASKS 



1R46I 


READER 


QUEUE 


P 


D 


C 


1R46I 


DISKCUMP 


00030 


9 


L 


A 


1R46I 


PAUSE 




00032 


9 


K 


A 


1R46I 


ONE 




00020 


3 


D 


A 


1R46I 


TWO 




00021 


3 


D 


A 


1R46I 


THREE 




00022 


3 


D 


A 


1R46I 


SIX 




00025 


3 


D 


A 


1R46I 


SEVEN 




00026 


3 


D 


A 


1R46I 


EIGHT 




00027 


3 


D 


A 


1R46I 


NINE 




00028 


3 


D 


A 


1R46I 


TEN 




00029 


3 


D 


A 


1R46I 


DITTO 




00033 


3 


L 


A 


1R46I 


PRINTLOG 


00031 


1 


K 


A 


1R46I 


FOUR 




00023 


3 


D 


B 


1R46I 


FIVE 




00024 


3 


D 


B 



***** 
***** 
***** 
***** 
***** 
***** 
***** 
***** 
***** 
***** 
***** 
***** 
***** 
***** 
***** 



1R46I 



LIST QUEUE NOTHING TO DISPLAY 



***** 



1R46I PUNCH QUEUE NOTHING TO DISPLAY 



***** 



If no POWER/VS account support is provided (either ACCOUNT=NO in POWER macro 
and/or JA=NO in DOS/VS FOPT macro), the account file statistics are replaced by 
the message: 

NO ACCOUNT SUPPORT 
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APPENDIX E-COMPARISON OF DOS/VS POWER AND POWER/VS 



GENERAL DIFFERENCES 



The following general differences exist between POWER/VS and DOS/VS POWER: 

A new set of POWER/VS messages has been created. 

POWER/VS direct access files are not compatible with DOS/VS POWER disk files. 

One read queue, one list queue, and one punch queue are maintained for the whole 
system. 

POWER/VS uses its own access methods. Therefore, programs that depend on any 
access method characteristic of earlier versions of POWER should be carefully 
reviewed before they are used under POWER/VS. 

DOS/VS POWER JECL statements are fully supported by POWER/VS. 

A new set of operator commands has been created for POWER/VS. The 
corresponding DOS/VS POWER commands are still valid, with the exception of 
the H, E, M, 0, and Z commands. 

A completely new set of remote commands has been defined for POWER/VS. The 
new commands are incompatible with DOS/VS POWER remote commands. 

The DOS/VS POWER AUTOSTART feature has been replaced by a new 
AUTOSTART feature. 

Remote users are defined by remote-id (number) not user-id (name). 

The IBM 2311 Disk Storage Drive is not supported as a spooling device. 

Unit-record I/O from subtasks in a multitasking environment is fully supported. 
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LOCAL OPERATION 





DOS/VS POWER 


POWER/VS 


Run mode 


Real 


Virtual 


Input classes 


Partition-dependent 


Both partition-dependent 
and partition-independent 
supported. 


Output classes 


Partition-dependent 
(Each partition has 
its own list and punch 
queues) 


Partition-independent 
(One list queue and one 
punch queue for all 
partitions) 


Output segmentation 


No 


Yes 


Generation 


Assembly required 


Short or no assembly 
required 


Initiation 


Automatic start-up of 
one input reader, one 
list writer, and one 
punch writer 


Automatic start-up of 

readers/writers 

and supported partitions 


Job accounting 


Spools DOS/VS and 
accounting data 
separately 


DOS/VS and POWER/VS 
accounting data merged 


Printer forms change 


Start of job, only 


At start or within job 


Permanent I/O error 


POWER may be canceled 


Only the POWER/VS task 
affected is canceled 


Flush with hold 


No 


Yes 


FCB support 


Partial 


Yes 


Forms setup assistance 


Partial 


Yes 


Queue management commands 


Yes 


Yes 


Hot local reader 


Yes 


Yes 


Warm start 


Yes 


Yes 


Page forward/backward 


Yes 


Yes 


Output page/card limit 
check 


Yes 


Yes 


Job separator pages 


SYSGEN option, only 


Yes; can be specified 
in a job stream 


Dummy devices 


Required for support 
of multiple partitions 


Not required for support 
of multiple partitions, 
but allows 8 dummy 
printers and 8 dummy 
punches to be used in 
each partition. 


Multiple Printer/Punch 
Support 


No 


YES; up to 8 printers 
and 8 punches 



( 
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REMOTE OPERATION 





DOS/VS POWER 


POWER A/S 


No. of RJE lines 


Up to 5 


Up to 25 L ,. 


RJE TP access method 


BTAM 


RTAM 


Hot RJE reader/writer 


No 


Yes 


RJE accounting 


No 


Yes 


Leased/switched line 
support 


Yes 


Yes 


ASCII RJE support 


No 


Yes 


Transparency feature 


Mandatory if punching 


Needed only if 
transmitting object 
decks 


RJE output routing 


Partial 


Yes 


Timeout 


Yes 


Yes; no maximum 
time limit 


RJE writer classes 


No 


Yes 


Print separators 


No 

■ ■ 


Yes 
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APPENDIX F-USER ACCOUNTING ROUTINE ($JOBACCT) 



SJOBACCT is an optional user-written routine through which user accounting informa- 
tion can be added to the DOS/VS accounting table in the supervisor. Subsequently, this 
is merged with POWER/VS accounting information in the POWER/VS partition to form 
a complete execution account record. 

$JOBACCT is called by $JOBCTLN upon reading either a /& statement or the second 
and subsequent // EXEC statements of a user job containing more than one job step; 
that is, $JOBACCT is called at the end of each job or job step. Register 14 contains 
the address of the return point. 

The user can, in $JOBACCT, test byte 164, bit of the communications region. If 
the bit is on, the partition in which the job step executed is under control of POWER/VS, 
and POWER/VS accounting is supported. 

To add additional information to the standard execution account record, the PUTACCT 
macro (supplied with POWER/VS) can be used. It has the format: 

PUTACCT (rl),(r2) 

Register rl must point to the area in $JOBACCT containing the user account 
information, and register r2 must contain the length of the area. The total length of 
the execution account record cannot exceed 2000 bytes. PUTACCT acts as a NOP if 
the partition is not supported by POWER/VS or if accounting is not supported by 
POWER/VS. 

After re-entering SJOBCTLN from $JOBACCT, the execution account record is written 
to the POWER/VS file. 

Refer to the DOS/VS System Management Guide, GC33-5371 for further information 
about DOS/VS $JOBACCT routines. 
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APPENDIX G-RDREXIT ROUTINE 



The RDREXIT routine permits each DOS/VS JCL statement or POWER/VS JECL 
statement to be examined as it is read by POWER/VS. Any statement can be changed 
or deleted, and other statements can be inserted. These changes do not permanently 
alter the JCL or JECL. 

Some of the ways the RDREXIT facility can be applied are: changing the disposition 
of a certain job class to hold during prime shift; changing the disposition of output 
to spool during the day or to write direct (i.e., no spooling) at night; causing a job 
to run real in one instance and virtual at other times; establishing a SIZE parameter on 
EXEC statements; gathering job accounting information. 

When POWER/VS is started, the phase (routine) specified in the RDREXIT parameter 
of the POWER macro is loaded into the POWER/VS partition. A POWER/VS read task 
gives control to this routine via a BALR 14,15 instruction after reading a DOS/VS 
JCL statement or POWER/VS JECL statement. The address of the statement is passed 
in register and the length in register 1. To exit from the routine, control must be 
returned to the read task via a BR 14 instruction. Between entry and exit from the 
routine, no operation may be performed by the RDREXIT that might cause a wait con- 
dition for the POWER/VS partition. The load address of the phase is not fixed, and there- 
fore must be self-relocating or the relocating loader option must have been specified 
during DOS/VS system generation. 

Before returning to the POWER/VS read task, a return code must be supplied in register 
15. The return codes are: 



Return code 


Meaning 


x'oo' 


Normal; the current statement will be processed by POWER/VS. 


X'04' 


Delete; the current statement will be ignored by POWER/VS. 


X'08' 


Insert; the new statement provided will be processed by 
POWER/VS. 


x'oc' 


Flush the DOS/VS job. 


X'10' 


Flush the POWER/VS job. 



When new statements are added (return code X'08'), the address of the statement must 
be passed in register 0, and its length passed in register 1. 

Any number of statements can be inserted. The original statement is re-presented after 
each inserted statement has been processed. When all the insertions have been made, 
a return code of X'00' orX'04' is placed in register 15 to accept or delete the original 
statement. 

The RDREXIT routine must not alter the contents of registers 10, 11, 12, or 13; these 
registers are reserved for POWER/VS internal use. Register 1 1 points to the task control 
block of the read task and can be used to identify the task. 

If ACCOUNT=YES was specified, number of records read in the read account record 
will include records added or deleted through the RDREXIT routine. 
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APPENDIX H - SAMPLE JOB STREAMS 



// JOB PAYINPUT 

// EXEC PAYSTEP1 

♦ 

// JOB PAYECIT 

* 

// EXEC PAYSTEP2 

♦ 

// JOB PAYSGRT 

♦ 

// EXEC PAYSTEP3 

* 

/£ 

* // JOB PAYCAROS 
/A JOB PAYCAROS 

♦ 

// EXEC PAYSTEP4 

* // LST FNC-CHEX 
// EXEC PAYSTEP5 
* 

/£ 

* // EOJ 

* // JOB PAYLIST 

* // LST C0PY«3,DISP«LtPRI*9 
//JOB PAYLIST 

# 

// EXEC PAYSTEP6 

* 

/€ 

* // EO J 

* //JOB JNM0ISKDUMP,PRI=9,CLASS=A f DISP«L 

// JOB DISKCUMP - DISPLAY POWER/VS FILE CONTENTS 

// ASSGN SYSOOOtSYSRES POWER/VS ACCOUNTING FILE 

// ASSGN SYS001»SYSRES POWER/VS QUEUE FILE 

// ASSGN SYS002.SYSRES POWER/VS DATA FILE 

// ASSGN SYS003,DISK,VOL»111111,SHR OPTIONAL 2ND EXTENT TC OATA FILE 

* DUMP FUNCTION«Q/D/A/ALL/JOBNAME(, JOB-NUMBER) /EOJ 
// EXEC IPW//CO 

/£ 

* SS EOJ 

* // JOB JNP*PRINTLGGtPRI»ltDISP*K 

//Job printlog display 
//exec printlog 

/£ 

* // JOB JNH*PAUSE,DISP*K,PRI*9 
// JOB PAUSEJ06 

// PAUSE * YOU ARE NOW IN CONTROLS ENTER JCL * 
/£ ■.'■.'. 

* SS JOB JNH»DITTO,DISP«L 
// JOB DITTC 

// EXEC DITTO 
/€ 

* // EOJ 
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POWER/VS 
Job Number 



DOS/VS 
Job Stream 



Comments 



©i 

©-: 



©H 



©-{ 



GH 







©- 



/ JOB ONE 

/ EXEC JOBSTEPA 

£ 

/ JOB TWO 

/ EXEC JOBSTEPB 

// PUN CL*SS=X 
/ EXEC JOBSTEPC 

£ 

// JOB THIRD 
/ JOB THREE 

/ EXEC JOBSTEPC 

£ 
// EOJ 

// JOB FORTH 
/ JOB FOUR 

/ EXEC JCBSTEPE 

/ EXEC JOBSTEPF 

£ 
// CTL CLASS=B 
// JOB FIFTH 

/ JOB FIVE 

/ EXEC JCBSTEPG 

£ 

// JOB SIXTH 
/ JOB SIX 

/ EXEC JOBSTEPH 

£ 

/ JOB SEVEN 

/ EXEC JOBSTEPI 

£ 

// JOB SEVENTH 
/ JOB EIGHT 

/ EXEC JOBSTEPJ 

// JOB EIGHTH 

/ EXEC JCBSTEPK 

£ 
// EOJ 

// CTL CL*SS=A 
/ JOB NINE 

/ EXEC JCBSTEPL 



Hill 



w* 



lips 



/ JOB TEN 
// LST FNC=8Xll 

/ EXEC JOBSTEPM 

// LST JSEP=2,RBS=100 
/ EXEC JOBSTEPN 



DOS/VS Job, 
: with no JCL changes. 



No * $$ JOB/EOJ required 
for LST or PUN statements. 



Optional POWER/VS JECL. 



No * $$ EOJ required, if 
POWER/VS job is followed 
by * $$ JOB statement. 

Default CLASS changed to B. 
No * $$ EOJ required. 



Multiple DOS/VS jobs 
in one POWER/VS job. 

(* $$ JOB and * $$ EOJ 
are both required for this.) 



Multiple POWER/VS jobs 
for one DOS/VS job. 



Default CLASS reset to A. 

POWER/VS will generate 
the missing /&. 



Multiple LST outputs per job. 
(2nd report is segmented.) 
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APPENDIX I - JOBS FOR SUGGESTED AUTOSTART PROCEDURE 



// JOB DISKLOAC PROGRAM CREATES POWER/VS AUTO-START DISK FILES 

// OPTION CATAL 

// OPTION NCDECK,NOXREF, CATAL 

PHASE DISKLOAOt* 
// EXEC ASSEMBLY 



THIS PROGRAM PERFORMS A CARD-TO-DISK FUNCTION. 



UOUT 



INPUT 



SYSIPT, UP TO /* 





PRINT 


NOGEN 




START 







BALR 


12,0 




USING 


*tl2 




OPEN 


CARD, UOUT 


LOOP 


EQU 


* 




GET 


CARD 




PUT 


UOUT 




B 


LOOP 


* 






END 


EQU 


♦ 




PUT 


UOUT 




MVC 


RECORD, EOJ 




PUT 


UOUT 




CLCSE 


CARD, UOUT 




EOJ 




* 






DISKREC 


OS 


2F 


RECORD 


DS 


CL80 


EOJ 

* 
CARD 


DC 


CL80V&6 • 


DTFDI 





OUTPUT = SEQUENTIAL DISK FILE •UOUT*, ASSGNED TO SYS005. 
RECORDS WRITTEN ARE DUPLICATES OF INPUT CARDS, 
FOLLOWED BY /*, /6 



ENTRY POINT 

INITIALIZE BASE REGISTER 
ESTABLISH ADDRESSABILITY 
OPEN FILES 

READ A CARD 

AND COPY IT TO OISK 

REPEAT FOR ALL INPUT CARDS UP TO /* 



COPY •/*• CARD 

PUT V6» IN I/C AREA 

AND WRITE •/£* ON DISK 

CLOSE FILES 

EXIT 

IOCS COUNT FIELD 

CARD INPUT/CUTPUT AREA 

/& CARD IMAGE 



DTFSD 



CEVADDR=SYSIPT, 
I0AREA1=REC0RD, 
EOFADDR=END, 
RECSIZE=80 

FOR 2314 OR 3330, CHANGE •DEVICE* SPECIFICATION BELOW. 

DEVADDR=SYS005, 

0EVICE=334G, 

BLKSIZE-88, 

I0AREA1=0ISKREC, 

TYPEFLE=OUTPUT 



/* 

// EXEC 
/S 



ENC 



LNKEDT 
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// JOB LCAC 6 FORMAT POWER/VS ALTO-START DISK FILES 

// ASSGN SYS005,SVSRES 

// DLBL UOUT, 'SYSIN. FILE. FOR. POWER/VS.START-UP.IN.F1', 99/365, SC 

// EXTENT SYSCC5, SYSRES, 1,0, 7428,4 1/3 CYL, 619 - 619, CN SYSRES 

// EXEC CISKLOAD 

/VS AUTO- START * 



p 


C W E 


CVCCN 


X'COC 


CVCCN 


X'OOO 1 


CVCCN 


X'OOE' 


CVCCN 


X«0«E» 


CVCUP 


X'COC 


CVCUP 


X'COD* 


CVCUP 


X»OOE« 



CVCUP X'O^E* 

ASSCN SYSLST, PR INTER 
// JOB POWER/VS 

ASSGN SYSOCO, SYSRES PONER/VS ACCOUNTING FILE 

ASSGN SYSC01, SYSRES POWER/VS QUEUE FILE 

ASSGN SYS002, SYSRES POWER/VS DATA FILE 

ASSGN SYSOG2,DISK,VOL = 111111,SHR OPTIONAL 2N0 EXTEKT TC CATA FILE 

// EXEC PCWERVS 
FORMAT=NC 
PSTART RCR»OOC 
PSTART LST,OOE 
PSTART LST,0«E,HBCA 
PSTART PUN,OOD,AXP 
PSTART F2.H2CA 
REACER=OCC 

PRINTERS«COE,01E,02E 
PUNCfcES-000,040 
PSTART F3,ABC3 
REACER=OCC 

PRINTERS«0CE,01E,02E 
PUNCFES*CCC,04C 
PSTART BCOABI 
REACER=OCC 

PRINTERS=OOE,01E,02E 
PUNCHES' COC, €40 
/* 

// CLBL UOUT, •SYSIN.FILE. FOR. F2. START-UP. UNDER. POWER/VS* ,99/365, SO 
// EXTENT SYSC05,SYSRES, 1,0,7432,2 1/6 CYL, 619 -619, ON SYSRES 

// EXEC CISKLOAD 

ASSGN SYSLST, PR INTER 

ASSGN SYSPCH,PUNCH 
// EXEC PROC=//ASSGN 

CLOSE SYSIN, READER 
/* 

// DLBL UOUT, f SYSIN. FILE.F0R.F3. START-UP. UNDER. POWER/VS', 99/365, SO 
// EXTENT SYSCC5, SYSRES, 1,0, 7434,2 1/6 CYL, 619 - 619, CN SYSRES 

// EXEC CISKLOAD 

ASSGN SYSLST, PRINTER 

ASSGN SYSPCH.PUNCH 
// EXEC PROC=//ASSGN 

CLOSE SYS IN, READER 
/* 

// DLBL LCUT,' SYSIN- FILE. FOR. F4. START-UP. UNDER. POWER/VS* ,99/365, SO 
// EXTENT SYSCC5, SYSRES, I, 0,7436, 2 1/6 CYL, 619 - 619, ON SYSRES 

// EXEC CISKLOAO 

ASSGN SYSLST, PRINTER 

ASSGN SYSPCI-, PUNCH 
// EXEC PROC=//ASSGN 

CLOSE SYSIN, READER 
/* 

// CLBL LCUT, • SYS IN .FILE. FOR. BG. START-UP. UNDER. POWER/VS*, 99/365, SC 
// EXTENT SYSCC5, SYSRES, 1,0, 7438, 2 1/6 CYL, 619 - 619, ON SYSRES 

// EXEC CISKLOAD 

ASSGN SYSLST, PRINTER 

ASSGN SYSPGH,PUNCH 
// EXEC PROC=//ASSGN 

CLOSE SYSIN, READER 
/* 
/€ 



< 
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/♦ 



/♦ 



// JOB CATALOG «$$ASSGN« PROCEDURES 
// EXEC MAINT 

CATALP $1ASSGN 

ASSGN SYSLST, PRINTER 

ASSGN SYSPCH. PUNCH 

ASSGN SYSO01,DISK,VOL«llllll,SHR 

ASSGN SYS002.SYS001 

ASSGN SYS003.SYS001 

ASSGN SYS004.SYS001 

ASSGN SYSLNK.SYSOOl 
/+ 

CATALP $2ASSGN 

ASSGN SYSLST, PRINTER 

ASSGN SYSPCH, PUNCH 

ASSGN SYS00l,DISK,VOL«222222,SHR 

ASSGN SYS002,SYS001 

ASSGN SYS003.SYS001 

ASSGN SYS004.SYS001 

ASSGN SYSLNK.SYSOOl 

CATALP S3ASSGN 

ASSGN SYSLST, PRINTER 

ASSGN SYSPCH, PUNCH 

ASSGN SYS001,DISK,V0L»333333,SHR 

ASSGN SYS002.SYS001 

ASSGN SYS003,SYS001 

ASSGN SYS004.SYS001 

ASSGN SYSLNK.SYSOOl 

CATALP $4ASSGN 

ASSGN SYSLST, PRINTER 

ASSGN SYSPCH, PUNCH 

ASSGN SYS001,DISK,V0L=333333,SHR 

ASSGN SYS002,SYS00i 

ASSGN SYS003.SYS001 

ASSGN SYS004.SYS001 

ASSGN SYSLNK.SYSOOl 

CATALP $BASSGN 

ASSGN SYSLST, PRINTER 

ASSGN SYSPCH, PUNCH 

ASSGN SYS001,DISK,VOL*111111,SHR 

ASSGN SYS002.SYS001 

ASSGN SYS003,SYS001 

ASSGN SYS004.SYS001 

ASSGN SYSLNK.SYSOOl 
/♦ 
/* 
/S 

// JOB CATALOG «$$PARSTD« POWER/VS START-UP PROCEDURES 
// EXEC NAINT 

CATALP $1PARSTD 
// OPTION PARSTD 

// DLBL IJSYSIN, 'POWER/VS. START-UP. SYSIN. FILE', 99/365, SD 
// EXTENT SYSRDR, SYSRES, 1,0, 7428, 4 1/3 CYL, 619 - 619, ON SYSRES 

* 'Fl* PARTITION STANDARD LABELS CREATED * 
/* 

/+ 

CATALP $2PARSTD 
// OPTION PARSTD 

// DLBL IJSYSIN, 'SYSIN. FILE. FOR. F2. ST ART-UP.UNDER. POWER/VS ',99/365, SD 
// EXTENT SYSRDR, SYSRES, 1,0,7432,2 1/6 CYL, 619 - 619, ON SYSRES 

* 'F2' PARTITION STANDARD LABELS CREATED * 
/* 

/♦ 

CATALP $3 PARSTD 
// OPTION PARSTD 

// DLBL IJSYSIN, 'SYSIN. FILE. FOR. F3. ST ART-UP.UNDER. POWER/VS ',99/365, SD 
// EXTENT SYSRDR, SYSRES, 1,0, 7434, 2 1/6 CYL, 619 - 619, ON SYSRES 

* 'F3' PARTITION STANDARD LABELS CREATED * 
/* 

/+ 

CATALP $4PARSTD 
// OPTION PARSTD 

// DLBL IJSYSIN, 'SYSIN. FILE. FOR. F4. ST ART-UP.UNDER. POWER/VS', 99/365, SD 
// EXTENT SYSRDR, SYSRES, 1,0,7436,2 1/6 CYL, 619 - 619, ON SYSRES 

* 'F4« PARTITION STANDARD LABELS CREATED * 
/* 

/♦ 

CATALP $BPARSTD 
// OPTION PARSTD 

// DLBL I JSYSIN,' SYS IN. F ILE.FOR.BG. ST ART-UP.UNDER. POWER/VS', 99/365, SD 
// EXTENT SYSRDR, SYSRES, 1,0, 7438, 2 1/6 CYL, 619 - 619, ON SYSRES 

* «BG' PARTITION STANDARD LABELS CREATED * 
/* 

/♦ 
/* 
/& 
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APPENDIX J - POWER/VS GENERATION EXAMPLES 



// JOB PCMER/VS COMPILE & CATALOG 


// OPTION NODECK,NOXREF,CATAL 


// EXEC 


ASSEMBLY 




PRINT NOGEN 


POWERVS 


POWER 




DBLK«516, 




TRACKGP«2t 




SUBLIB«P V 




ACCOUNT«YES. 




JSEP«(lt5), 




RBS*(0.1000) 




END 


/* 




// EXEC 


LNKEOT 


/£ 





TAILORED NON-RJE VERSICN OF POWER/VS 



REF=3 



END 
/* 

// EXEC LNKECT 
/£ 



// JOB CREATE EXAMPLE »R JE • VERSION CF POWER/VS 
// OPTION NOOECK,NOXREF,CATAL 
// EXEC ASSEMBLY 

PRINT NOGEN 

POWERTP POWER X 

DBLK=516, X 

TRACKGP=2, X 

SUBLIB«P* X 

ACCOUNT«YES f X 

JSEP = (1,5), X 
RBS=(0,lCOO) 

PLINE X 

ADOR-X'OSOS X 

PSWRD= SECRET. X 

TIMEOUT-NO, X 

TRNSP-YES. X 
CODE=EBCDIC 

PL INE X 

A0OR=X«031S X 

PSWRD-MUSTKNOW, X 
CODE=ASCII 

PLINE X 
ADDR=X•032• 

PRMT X 

REMOTE^ It X 
TYPE=2770 

PRMT X 

REMOTE=2 f X 
TYPE=2780 

PRMT X 

REMOTE=3. X 
TYPE=3780 

PRMT X 

REM0TE=4, X 

TYPE*=3780, X 

LSTROUT=100. X 

PUNROUT=100. X 

TRNSP=YES, X 

BE=YESt X 

HFC=NO, X 

SCE=NO f X 

ABE=NO, X 

CS=NO, X 

MRF=NO t X 

TRACE=NO, X 
LIST=120 

PRMT X 

REMOTE=5. X 
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) 



# 






APPENDIX K-POWER/VS OPERATOR MESSAGES 

IQxx = POWER/VS MESSAGES 

1Q01I POWER/VS CANNOT RUN IN REAL MODE 

Cause: POWER/VS can only be executed in virtual mode. 

System Action: POWER/VS initialization is terminated. 

Operator Action: Omit the REAL parameter from the // EXEC card that causes 
DOS/VS to load POWER/VS. 

1Q02I POWER/VS CANNOT RUN AS A SUBTASK 

Cause: POWER/VS is attached as a subtask to a maintask. POWER/VS must 
run as a maintask. 

System Action: POWER/VS initialization is terminated. 

Programmer Action: Change the environment of POWER/VS so that it runs as 
a maintask in one of the five partitions. 

1Q03I INSUFFICIENT REAL STORAGE AVAILABLE. xxK REQUIRED 

Cause: Not enough real storage is provided for the POWER/VS partition. 

System Action: POWER/VS initialization is terminated. 

Operator Action: Use the ALLOCR statement/command to increase the size 
of the real partition that corresponds to the POWER/VS partition. The real 
partition must be at least as large as indicated in the message. 

1Q04I QUEUE FILE MISMATCH 

Cause: Either (1) warm start is tried with a version of POWER/VS different 
from the one which formatted the existing queue file, or (2) warm start was 
tried on the data file and cold start on the queue file (FORMAT=q) but the 
physical blocksize of the data file does not match the DBLK value specified 
during POWER/VS generation. 

System Action: POWER/VS initialization is terminated. 

Operator Action: Reformat the queue file by performing a cold start of POWER/VS. 
If the information in the queue file is required, you must restart using the original 
version. 

1Q05I PAGEABLE AREA nnnK TOO SMALL 

Cause: The size of the pageable area in the POWER/VS partition is not large 
enough to contain the POWER/VS code. 

System Action: POWER/VS initialization is terminated. 

Operator Action: Enlarge the size of the pageable area by nnnK bytes. To do 
this, either use the ALLOC statement/command to increase the size of the 
POWER/VS partition by nnnK bytes, or use the ALLOCR statement/command 
to decrease the size of the corresponding real partition by nnnK bytes. 
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1Q06I SYSLOG NOT ASSIGNED TO CONSOLE 

Cause: POWER/ VS detects that SYSLOG is not assigned to a console device. (f 

System Action: POWER/VS initialization is terminated. 

Operator Action: Assign SYSLOG to the console and restart POWER/VS. 

1Q07I INVALID LOGICAL UNIT filename 

Cause: The indicated file could not be opened successfully. 

System Action: POWER/VS initialization is terminated. 

Operator Action: Check for errors in the DOS/VS job control statements or com- 
mands defining the file. 

1Q08I SUPERVISOR WITHOUT POWER/VS SUPPORT 

Cause: Self explanatory. 

System Action: POWER/VS initialization is terminated. 

Programmer Action: A different supervisor must be used with the generation option 
POWER=YES specified in the SUPVR macro. 

1Q09I TRACKGROUP CHANGED TO nn 



Cause: (1) The total number of track groups that has been calculated from the 
specified extent size and the TRACKGP parameter in the POWER macro is larger 
than the total number of queue records.(2) The TRACKGP specification exceeds 
the maximum number of tracks per cylinder of the disk assigned to the data file. 

System Action: The TRACKGP specified during POWER/VS generation is ignored. 
POWER/VS calculates a new TRACKGP number (nn) and processing continues. 

Operator Action: None. 

1Q10I SUPERVISOR WITHOUT ACCOUNTING SUPPORT 

Cause: ACCOUNT=YES has been specified during POWER/VS generation, but a 
DOS/VS supervisor is used without job accounting support. 

System Action: POWER/VS continues processing without accounting support. 

Operator Action: None. 

1Q11D FORMAT QUEUES= 



Cause: This message is issued when POWER/VS is initialized either without using 
the AUTOSTART procedure, or with the AUTOSTART procedure but the 
FORMAT= command was omitted or invalid. 



System Action: POWER/VS waits for the operator's reply. 



I I 
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Operator Action: Reply with one of the following: 

dW 
qQa] 

a 

NO 

END or ENTER only. 

where: 

d: specifies that the data file and the queue file should be formatted. 

q: specifies that only the queue file should be formatted. Note that any data in 
the data file is effectively deleted, since pointers to the data file in the queue file 
records are cleared. 

a: specifies that the account file should be formatted. Because the POWER/ VS 
account file is composed of variable-length records, it is not pre-formatted in the 
same way as the queue file and the data file. Instead, pointers are set to position 
the account output at the beginning of the file. 

NO or END or ENTER: specifies that no formatting is desired (warm start). 
1Q12I POWER/ VS INITIALIZATION COMPLETED 

Cause: POWER/VS has been initialized. 

System Action: The system enters the wait state until the operator enters the 
next command, or the system continues by processing any commands entered 
via the AUTOSTART procedure. 

Operator Action: Enter next command, if no AUTOSTART. 

1Q13I ERRONEOUS AUTOSTART CARD(S) READ 

Cause: During the AUTOSTART procedure an invalid FORMAT= command was 
issued. 

System Action: The system issues message 1Q11D FORMAT QUEUES^ so that the 
operator can submit the correct information. 

Operator Action: None. 

1Q14I NO MATCHING PUB FOR cuu 

Cause: The RJE line indicated by its channel and unit number (cuu) is defined 
in POWER/VS but not in the DOS/VS supervisor. 

System Action: The line is deleted from POWER/VS. 

Operator Action: Re-IPL the system and ADD the line, or continue without 
using the line. 

1Q15I PHASE phasename NOT FOUND 

Cause: This POWER/VS phase cannot be found in the private core image library 
that is mounted or in the system core image library. 

System Action: POWER/VS initialization is terminated. 

Operator Action: Mount the correct private core image library or catalog the 
phase into the core image library. Then restart POWER/VS. 

Appendix K - POWER/VS Operator Messages 18.3 



1Q16I INVALID LST/PUN ROUTING FOR remid 

Cause: A remote block is detected describing a user whose list or punch output 
is to be routed to a non-existing remote-id. 

System Action: The default list or punch routing for this remote-id is reset to 
(central location). 

Operator Action: Notify the systems programmer. 

Programmer Action: Correct the remote-id. 

1Q17I QUEUE FILE TOO SMALL 

Cause: There are not enough entries in the queue file to cover all track groups in 
the data file. 

System Action: Part of the data file will not be used. 

Operator Action: Notify the systems programmer. 

Programmer Action: Increase the size of the queue file or decrease the size of the 
data file. 

1Q181 TOO MANY EXTENTS IJDFILE 

Cause: More than five extents were used for the data file. 

System Action: POWER/VS initialization is terminated. 

Operator Action: Change the EXTENT cards for the IJDFILE so that there are 
no more than five extents and restart POWER/VS. 

1Q19I INVALID EXTENT IJDFILE 

Cause: A submitted extent for the data file does not start on head or does not 
end on a cylinder boundary. 

System Action: POWER/VS initialization is terminated. 

Operator Action: Correct the EXTENT information and restart POWER/VS. 

1Q20I AUTOSTART IN PROGRESS 

Cause: Self explanatory. 

System Action: As indicated by the message. 

Operator Action: None. 

1Q21I POWER/VS HAS BEEN TERMINATED 

Cause: The PEND command was issued and all POWER/VS tasks have been ter- 
minated. 

System Action: The POWER/VS partition is restored for normal DOS/VS operation. 

Operator Action: None. 
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1Q22I POWER/VS ALREADY ACTIVE 



Cause: An attempt was made to initialize POWER/VS but POWER/VS is 
already active. 

System Action: The initialization is terminated. POWER/VS continues proces- 
sing. 

Operator Action: None. 
1Q30D ABNORMAL POWER/VS TERMINATION. PRINTER^ 

Cause: One of the POWER/VS tasks was terminated abnormally. 

System Action: POWER/VS waits for the operator's reply. After acknowled- 
ging the operator's reply, the POWER/VS session is terminated. 

Operator Action: If you want a dump, specify the channel and unit number 
(cuu) of a printer. If you do not want a dump, reply NO or press end-of-block. 

1Q31I MORE THAN 80% FULL ACCOUNT FILE (IJAFILE) ******* 

Cause: 80% of the POWER/VS account file is already filled. 

System Action: Processing continues. 

Operator Action: Issue a PACCOUNT command to empty the account file. 

1Q32I NO MORE ACCOUNT FILE (IJAFILE) SPACE FOR ttt.cuu 

Cause: The account file is full. 

System Action: The task (identified by ttt and its accompanying cuu) issuing 
the message is put in the wait state. It is automatically reactivated when the 
account file is emptied. 

Operator Action: Empty the account file by issuing the PACCOUNT command. 

1Q33I STOPPED ttt,cuu 

Cause: The PSTOP command was issued to terminate a particular POWER/VS 
task or to release a partition from the control by POWER/VS. 

System Action: The reader/ writer task (identified by ttt and its accompanying 
cuu) is detached from POWER/VS and the real storage it was using is released. 

Operator Action: None, 
sc 

1Q34I {pp} WAITING FOR WORK ToN cuu] 

Cause: This message occurs when there is no data for an execution processor 
or reader/writer task to process. 

System Action: The task (ttt) or partition (pp) remains active but its data 
buffers are released. When data is made available again for processing on cuu, 
the stopped task will automatically continue. 
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Operator Action: Place more input in the card reader, or make list and punch 
output available for processing. If there is no more work to be done, issue a 
PSTOP command to stop the task. 



1Q35I EOF ON cuu 

Cause: The last card read from cuu was not a job delimiter statement, either 
* $$ EOJ or /&. 

System Action: The reader task issuing the message is put in the wait state. 

Operator Action: Put the missing card(s) in the card reader (cuu) and ready 
the device. 

1Q36I ttt CANCELED DUE TO I/O ERROR ON cuu 

Cause: The DOS/VS error recovery routines detected a cancel condition during 
an I/O operation requested by the task (ttt) on the specified unit cuu, or the 
operator replied CANCEL on a decision type message issued by the DOS/VS 
error recovery routines. 

System Action: The task is canceled. In case of an error that disrupts 
operation, for instance, an error on the master queue record, the POWER/VS 
partition is canceled, thus terminating the system and restoring DOS/VS for 
normal operation. 

Operator Action: Perform the normal action required for the related DOS/VS 
error recovery message that accompanies this message, before reactivation of the 
task or before reinitialization of POWER/VS. 

1Q37I JECL CARD INCORRECT NEAR COLUMN n 

Cause: There is an error in the format or the contents of an operand near 
column n in the JECL card. 

System Action: The JECL statement in error is printed on the console together 
with the above message. The invalid operand is replaced by its system default 
value. 

Programmer Action: If you do not want the default, correct the JECL statement 
and resubmit the job. 

1Q38I NO DASD SPACE AVAILABLE FOR ttt,cuu 

Cause: A reader task, RJE task or execution processor has requested a queue file 
record or track group, and none is available. 

System Action: The task issuing the message is put in the wait state. When a 
queue file record or track group becomes available, the task is reactivated automa- 
tically. 

Operator Action: To make DASD space available, either 

(1) Start a list or punch writer task to process queue entries in the output queue. 
After all output from a queue entry has been processed, the queue file record 
and the associated track groups are freed. 

(2) Delete a queue entry from the queue file. After deletion of a queue entry, the 
queue file record and the associated track groups are freed. 
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1Q39I JOB jobname FLUSHED BY THE OPERATOR 

Cause: The operator issued a PFLUSH command to discontinue processing the 
output from this job. 

System Action: If a writer task was flushed, this message is printed on the 
console, and also on the printer if a list task was flushed. 

Programmer Action: Check with the operator. 
1Q40A ON cuu FORMS ffff NEEDED FOR jobname jobnumber 



Cause: In a * $$ LST (or PRT) statement or a * $$ PUN statement the 
programmer has requested a special type of forms or cards for the output 
of the specified job. 

System Action: This task waits for the operator to change the forms. 
Processing continues for other POWER/ VS tasks. 

Operator Action: Mount the forms that are indicated in the message. To 
check the forms alignment on the printer, issue a PSETUP command (you 
can adjust the alignment during the printing). Issue a PGO command to 
reactivate the job. 



1Q41I WRONG PRINTER/PUNCH FOR jobname cuu 

Cause: The printer or punch available to the list or punch task is not command 
compatible with the printer/punch assigned to the partition in which the job was 
executed. 

System Action: The incompatible commands are ignored. 

Operator Action: None, but if you did not want the commands ignored, enter a 
FLUSH,HOLD command to prepare for restarting on another printer. 

1Q42I PAGE/CARD COUNT EXCEEDS END QUEUE ENTRY FOR cuu 

Cause: A PRESTART command is entered with too great a forward page or 
card count. 

System Action: The command is ignored. 

Operator Action: Reenter the command with a smaller forward page or card 
count. 

1Q43I END OF SPOOL TAPE fLST \ ,cuu 

(PUN/ 

Cause: The logical end of a spool tape was reached for the indicated output 
writer task. (All data has been processed). 

System Action: The tape is rewound and unloaded. The writer task is stopped. 

Operator Action:If there are more tapes to be printed or punched, start a new 
writer task. 
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1Q44I BOOK library. bookname NOT FOUND 

Cause: The programmer has requested a book that cannot be found in the 

specified (sub)library. 

System Action: The job is flushed. Message 0S01I is then issued. 

Operator Action: None. 

Programmer Action: Correct the bookname in the * $$ SLI statement and 

resubmit the job, or ensure that the book is cataloged in the source statement 

library for the next time. 

1Q45I SLI STATEMENT NOT SUPPORTED 

Cause: An SLI statement was used in a job but POWER/VS was not generated 
with the SUBLIB parameter. 

System Action: The job is flushed. Message 0S01I is then issued. 
Operator Action: None. 

1Q46I DISP FORCED TO D FOR jobnamejobnumber 

Cause: In the * $$ LST or * $$ PUN statement disposition N was specified 
but the SYSLST or SYSPCH device is not available. 

System Action: The output is spooled. 

Operator Action: None. 



1Q47I iBG( jobname jobnumber I FROM remidj I user-information] 

Cause: An * $$ JOB card was read and the JLOG option is in force. 
System Action: None. 
Operator Action: None. 

1Q48I NO MATCHING SPOOL DEVICE JBGl 

lFn( 

Cause: The LST or PUN statement that is printed prior to this message addres- 
ses a partition for which no spool device has been set up by a PSTART com- 
mand, or the device address in the LST or PUN statement does not agree with 
the spooling device assigned to the partition. 

System Action: This LST or PUN statement is ignored. 

Operator Action: Compare the statement with the device assignments. If PSTART 
has not been issued for the device, then flush the job, PSTOP the partition, 
enter the appropriate PSTART command, and resubmit the job. If the statement 
is an error, correct it and resubmit the job. 
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1Q49I INVALID DELIMITER 



te! 



Cause: A parameter in the statement printed prior to this message is not followed 
by a blank or a comma. 

System Action: The statement is ignored. 

Operator Action: None, if the defaults for the statement are acceptable. Otherwise, 
correct the card and resubmit the job. 



1Q50I UNKNOWN KEYWORD 



<» 



Cause: POWER/VS does not recognize one of the keyword parameters in the JECL 
statement printed above this message. 

System Action: The JECL statement is ignored. 

Operator Action: Correct the statement and resubmit the job. 

1Q51I INVALID pppppppp PARAMETER /BG\ 

w 

Cause: The parameter pppppppp in the JECL statement printed above this message 
is invalid, pppppppp can be one of the following: DISP, CLASS, FNO, COPY, 
TADDR, LTAB, REMOTE, JSEP, RBM, RBS, UCS, FCB, LST, PUN, JNM, USER. 

System Action: The JECL statement is ignored. 

Operator Action: Correct the statement and resubmit the job. 

1Q52I OUTPUT LIMIT EXCEEDED FOR jobname jobnumber /BG\,cuu 

Cause: The number of list or punch records established by the RBM parameter in 
the LST or PUN statement (or otherwise by the STDLINE or STDCARD para- 
meter of the POWER macro) is exceeded. 

System Action: Processing of this job continues. 

Operator Action: Issue a PSTOP or PFLUSH, if desired. 

1Q53I OUTPUT SEGMENTED FOR jobname jobnumber (BG\,cuu 

\Fn f 

Cause: Output segmentation occurs because the number of records specified in the 
RBS parameter or in the * $$ LST statement (or PRT) or in the * $$ PUN 
statement is exceeded. 

System Action: Processing of this job continues. 
Operator Action: Start a writer task. 

1Q54I /FCB! ERROR FOR jobname jobnumber Ibg\ 
(UCS/ \Fnj 

Cause: The FCB or UCS parameter was specified in the * '$$ LST statement. The 
phase to be loaded either has an error or is not present in the core image library. 

System Action: The parameter is ignored and LTAB is set to the default. 

Operator Action: If the job is dependent on the FCB or UCS phase, correct the 
error and resubmit the job, or use the attention routine FCB or UCS commands 
when the job is directed to a printer. 
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1Q55D SPECIFY TAPE ADDRESS FOR jobname jobnumber {p^}' cuu 

Cause: The disposition was specified as T in the * $$ LST or * $$ PUN state- 
ment, but no tape address was specified. 

System Action: Wait for operator response. 

Operator Action: Enter the tape address in the form X'cuu'l,X'ssJ or cuu Lx'ssJ 
or press end-of-block to set the disposition to D (disk intermediate storage). 

ir>c* T TxmATir* iTAPE ADDRESS) /BG) 
1Q56I INVALID j M0DE gET J {^J 

Cause: The response to message 1Q55D was either invalid or not a tape, the tape 
address in the LST or PUN statement was not a valid tape drive, or the tape drive 
is owned by another partition. 

System Action: Issue message 1Q55D. 

Operator Action: None. 

1Q57A WRITE RING REQUIRED ON cuu ttt,cuu 

Cause: No file protect ring is on the tape (cuu) that was indicated in the response 
to message 1Q58A. 

System Action: ttt,cuu (the task-ID) is put in the wait state. The tape (cuu) is 
rewound and unloaded. 

Operator Action: Put a ring on the tape. Enter PGO ttt,cuu (where ttt,cuu is the 
same as it appears in this message). 

\ 

1Q58A MOUNT TAPE ON cuu FOR jobname jobnumber ttt,cuu 

Cause: A valid tape address was found in the LST or PUN statement and the ope- 
rator is requested to mount the tape. 

System Action: ttt,cuu (task-ID) waits for the operator to respond. 

Operator Action: Mount the tape as requested. Then issue PGO ttt,cuu (where 
ttt,cuu is the same as indicated in the message). 

1Q59I ttt,cuu WAITING FOR REAL STORAGE 

Cause: Insufficient real storage is available during execution. 

System Action: The task (ttt,cuu) is put in the wait state until another task re- 
leases storage for the present task to use. 

Operator Action: If the message is repeated often, allocate more real storage to 
this partition. 

1Q60I OPEN FAILURE ON PACCOUNT OUTPUT DEVICE 

Cause: A PACCOUNT command was issued but the required output device cannot be 

opened, most likely due to incorrect DLBL or EXTENT information (DASD) or incorrect I 

TLBL information (standard labeled tape). 
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System Action: The PACCOUNT command is not executed and the account file 
is still intact. 

Operator Action: Correct the label information or the problem that caused the open 
failure and submit the PACCOUNT command again. 

1Q61I UNRECOVERABLE I/O ERROR ON //SYSTEM SSL I 

(PVT SSL cuu/ 
l(AFILE) 
,toFILE> n cuu 
IfDFILE) 

PACCOUNT OUTPUT DEVICE 

cuu 



Cause: An unrecoverable I/O error occurred on the file indicated in the message 

as the following: 

SYSTEM SSL = system source statement library 

PVT SSL cuu = private source statement library cuu 

AFILE cuu = account file SYS000 cuu 

QFILE 1 cuu = queue file SYS001 cuu 

DFILE 2(-6) cuu = data file SYS002 (-SYS006) cuu 

PACCOUNT OUTPUT DEVICE = as specified in the PACCOUNT command 

cuu = channel and unit number 

System Action: Error bypass procedures will be performed for which another message 
will be issued. The task is terminated. 

Operator Action: See explanation and recommended operator procedure for the 
accompanying messages. 

1Q62I CANCEL FOR POWER/ VS IGNORED 

Cause: The CANCEL job control command was issued for the POWER/VS par- 
tition. 

System Action: Processing continues. 

Operator Action: To cancel POWER/VS, issue the PEND KILL command. 

1Q63I UNRECOVERABLE I/O ERROR IN QUEUE MASTER REC cuu 

Cause: Self-explanatory. 

System Action: POWER/VS is terminated with message 1Q76I. 

Operator Action: Perform a POWER/VS cold start with different extents for 
IJQFILE and IJDFILE. Resubmit all jobs not yet processed. 

1Q64I JOB jobname (RDR/ SET DELETED 

<PUN> 
(LST ) 



Cause: An unrecoverable I/O error was caused by a data record in a trackgroup 
or one of the queue records in the queue set. 

System Action: The entire queue set for this job or job segment is deleted and the 
associated track groups from the POWER/VS data file will not be used again. The 
task is terminated with an additional message. 

Appendix K - POWER/VS Operator Messages 18.11 



Operator Action: Resubmit the job indicated in the message (after performing back- 
up procedures, if necessary, on the user master file). If, after the last cold start, 
this message appears frequently, it may indicate that system performance is being 
affected by an increasing number of unusable track groups on the data files. Com- 
plete all jobs still in the queues, initialize the disk(s) on which IJQFILE and 
IJDFILE reside, assign alternate tracks as necessary, and perform a cold start. 
Different extents may be desirable for better performance if there are too many 
alternate tracks assigned for the original extents. 



1Q65I UNKNOWN (RDR) SET DELETED 

<PUN[ 

/lst ) 



Cause: An unrecoverable I/O error occurred on the qeue file while POWER/VS was 
scanning the reader, punch, or list queues. 

System Action: The queue set for this job or job segment is deleted and the asso- 
ciated track groups from the spool files will not be used again. The task is termi- 
nated. 

Operator Action: Refer to action for message 1Q64I. 
1Q66I ACCOUNT FILE KEPT 

Cause: An unrecoverable I/O error occurred on the account file (IJAFILE) or on the 
PACCOUNT output device after a PACCOUNT command was issued. The IJAFILE 
file is still intact. 

System Action: The PACCOUNT task is terminated with message 1Q72I. 

Operator Action: If the I/O error occurred on the PACCOUNT output device, 
issue the PACCOUNT command again with a different output device. 



1Q67I FREE SET NOT ACCESSIBLE 

Cause: An unrecoverable I/O error occured on the queue file (IJQFILE). 1 

System Action: POWER/VS is terminated with message 1Q76I. 

Operator Action: Perform a warm start and process all existing output queue entries 
(PUN and LST). Initialize the disk on which IJQFILE resides and assign alternate 
tracks as necessary. After a cold start, with different extents if necessary, resub- 
mit all jobs in the input (RDR) queue. 

1Q68I SEGMENTATION FORCED FOR jobname jobnumber /BG\ ,cuu 



m 



Cause: An unrecoverable I/O error occurred on the IJQFILE or IJDFILE. 

System Action: Message 1Q69I is issued. The partition continues to run. If the 
I/O error occurred in an output queue set of this partition, it is deleted. 

Operator Action: If message 1Q64I was also issued, cancel the job in the partition 

and resubmit it after performing backup procedures on the user master files. j 
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1Q69I DEFAULT OPTIONS TAKEN FOR jobname jobnumber (BG\ ,cuu 



{£} 



Cause: An unrecoverable I/O error occurred and after output segmentation all options 
in JECL commands are set to their defaults. 

System Action: Processing continues on this basis. 

Operator Action: If the defaults are not suitable, resubmit the job. 

1Q70I TASK FAILURE, STOPPED (BG) 

iFnf 

Cause: An unrecoverable I/O error occurred on the queue file or the data file while 
reading input qeues into the partition specified in the message. 

System Action: A PSTOP is forced for the partition. If the message 1Q64I was not 
also issued, then the queue set is returned to the spool files in either the leave state 
(if it was in the keep state), or the hold state (if it was in the dispatchable state). 

Operator Action: Issue an UNBATCH job control command followed by a POWER/VS 
PSTART command. The partition will continue with the next job in the queue. If 
the reader set was not deleted (as indicated by message 1Q64I), perform user file 
backup procedures as required and issue the PRELEASE command for this job. 



1Q71I (RDR) ,cuu TERMINATED 

<LST 
(PUN) 



Cause: An unrecoverable I/O error occurred on the queue file or the data file or 
the unit record device on cuu. 

System Action: Processing continues with other tasks. 

Operator Action: Take the appropriate corrective action for the device on cuu. 
Issue PSTART for the task and device (or another device of the same type) to 
continue processing. If a reader task was terminated, resubmit any jobs that were 
incompletely read. 

1Q72I PACCOUNT TERMINATED 

Cause: An unrecoverable I/O error occurred during the PACCOUNT process. 

System Action: The PACCOUNT task is terminated. 

Operator Action: Try the PACCOUNT command again with a different output 
device if the I/O error occured on the output device specified in the PACCOUNT 
command. Otherwise, if the error occured on IJAFILE, see message 1Q74I. 

1Q73I STATUS DISPLAY TERMINATED 

Cause: An unrecoverable I/O error occurred on the queue file or the printer. 
System Action: The report is not continued. Processing continues with other tasks. 
Operator Action: Reissue the PDISPLAY command. 
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1Q74I ACCOUNT SUPPORT FUNCTIONS TERMINATED 

Cause: An unrecoverable I/O error occured on the account file (IJAFILE). 

System Action: POWER/VS accounting support is immediately terminated. 

Operator Action: Issue a PEND command to finish processing of all currently 
running jobs (without accounting support). To regain accounting support and 
save the IJAFILE, do the following: 

1) Perform a warm start (FORMAT QUEUES=NO). 

2) After POWER/VS is initialized, issue a PACCOUNT (or J) command to save 
as much of the current account file as possible. 

3) Perform a cold start on the IJAFILE with different extents and perform a 
warm start on IJQFILE and IJAFILE (FORMAT QUEUES=A). 

IQ75I MULTIPLE TERMINATION OF TASK, POWER/VS TERMINATED 

Cause: An unrecoverable I/O error occured during processing of an earlier I/O 
error. 

System Action: POWER/VS is terminated. 

Operator Action: Check the previous message and determine if you want to warm 
start POWER/VS. 

1Q76I POWER/VS CANNOT CONTINUE 

Cause: An unrecoverable I/O error occured on the qeue file that cannot be by- 
passed. 

System Action: Issue message 1Q30D. 

Operator Action: Check the previous messages and determine if you want to warm 
start POWER/VS. 

1Q77I INVALID SPOOL TAPE FOR iLST) ,cuu 

(PUN/ 

Cause: Either the spool tape is not a valid POWER/VS spool tape, or the tape 
does not correspond with the type of writer task (a list writer cannot be for a 
punch spool tape and a punch writer cannot be for a list spool tape). 

System Action: The tape is rewound and unloaded. The writer task is stopped. 

Operator Action: Mount the correct tape and start a writer task (using the 
PSTART command). 

1Q78I NO REAL STORAGE AVAILABLE FOR ACT,cuu 

Cause: The PACCOUNT command was issued but there is not enough real storage 
for the account file saving task to execute. 

System Action: The account file saving task is terminated. 

Operator Action: Retry the PACCOUNT command a few times. If it is still unsuc- 
cessful, do one of the following, whichever applies: 

1) If you had entered the PACCOUNT command because the account file was 80% 
full (message 1Q31I), then enter the PSTOP command for one of the partitions 
under POWER/VS control. When this partition is stopped, re-issue the PACCOUNT 
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command. 

2) If you had entered the PACCOUNT command because the account file was 
completely full (message 1Q32I), then enter the. PSTOP command for one or more 
POWER/VS tasks. Reissue the PACCOUNT command. 



1Q79I ACCOUNT FILE SAVED 



Cause: The system has saved the account file as requested by the operator in a 
PACCOUNT command. 

System Action: All DASD space allocated to the account file is made available for 
storing more account records. All tasks that are in the wait state, because they 
failed to write an account record, are automatically reactivated. 

Operator Action: None. 



1Q80I ACCOUNT FILE ERASED 

Cause: The account file has been deleted in response to a PACCOUNT DEL com- 
mand. 

System Action: The account file extent is re-initialized. All tasks that are in the 
wait state, because they failed to write an account record, are automatically reac- 
tivated. 

Operator Action: None. 
1Q81I 'filename' EXTENT TOO SMALL, COMMAND NOT EXECUTED 



Cause: A PACCOUNT command was issued to copy the account file to a disk 
extent (filename as indicated in the message), which is not large enough to con- 
tain all the account information. 

System Action: If the account file was 100% full, the system remains in a wait 
state until the operator issues a valid PACCOUNT command. If the account file 
was not full, the system continues processing. 

Operator Action: Issue the PACCOUNT command again, possibly specifying a 
different medium. 



1q82i i/o error during (cp) , power/vs terminated 

)tt( 



Cause: An unrecoverable I/O error occured during execution of CP (command 
processor). IT (initialization), or TT (task termination). 

System Action: The POWER/VS partition is canceled. 

Operator Action: First, try to warm start POWER/VS. If this is unsuccessful, then 
cold start POWER/VS and resubmit all jobs that were not processed completely. 
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1Rxx = POWER/VS RJE AND POWER/VS COMMAND PROCESSOR MESSAGES 



Central Messages 



1R02I LINE cuu STOPPED 

Cause: The central operator issued a PSTOP command to stop the line (cuu). 

System Action: After this message is displayed at the central system, the system 
displays message 1R17I LINE HAS BEEN STOPPED for each remote-ID signed on. 

Operator Action: None. 

1R03I INVALID DEVICE TYPE FOR cuu 

Cause: The line address (cuu) specified in the PSTART command is known to the 
DOS/VS supervisor, but the device type is not 2701 or 2703. 

System Action: The PSTART command is ignored. 

Operator Action: Specify the correct line address in the PSTART command (if 
2701 or 2703: otherwise, you will not succeed). 

1R04I NO PLINE MACRO GENERATED FOR cuu 

Cause: The line address (cuu) specified in the PSTART command is known to the 
DOS/VS supervisor, but not to POWER/VS 

System Action: The PSTART command is ignored. 

Operator Action: Reassemble POWER/VS with a PLINE macro for this line. 



Remote Messages 



1R11I INVALID STOP COMMAND 

Cause: Invalid parameters were specified with the STOP command. 

System Action: The STOP command is ignored. 

Operator Action: Correct the STOP command and re-issue it. 

1R12I INVALID CLASS SPECIFICATION 



Cause: The class specified in a remote START command is invalid. Either (1) more 
than four characters were specified, (2) two of the same characters were specified, 
or (3) a character other than A-Z was specified. 

System Action: The START command is ignored. 

Operator Action: Reenter the correct START command. 



< 
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1R13I INVALID TASK SPECIFICATION 

Cause: The task specified in a remote START command is neither LST nor PUN 
nor MSG. 

System Action: The START command is ignored. 

Operator Action: Reenter the correct START command. 

1R14I EOF ON THE READER 



Cause: An end-of-file condition occured at the terminal reader before EOJ. 

System Action: The RJE reader routine is put in the wait state. If no operator 
response within n minutes (n is specified during POWER/VS generation in the 
TIMEOUT parameter), the terminal is signed off and the job is flushed. 

Operator Action: Supply the reader with the rest of the job and ready the reader 
to continue. 



1R15I REMOTE remid SIGNED ON 

Cause: A remote user (identified by his remote— ID) entered a valid SIGNON 
command. 

System Action: The terminal is logically attached to the central system. 

Operator Action: None. 

1R16I REMOTE remid SIGNED OFF 

Cause: A remote user (identified by his remote-ID) entered a valid SIGNOFF com- 
mand or he entered a SIGNON command at a processing terminal. 

System Action: The terminal is logically detached from the central system. 

Operator Action: None. 

1R17I LINE HAS BEEN STOPPED 

Cause: The central operator stopped the line. 

System Action: The terminal is detached and all used storage space is released. The 
input queue entry in process is not made, or the output queue entry in process is 
preserved, depending on the processing mode. 

Operator Action: Wait until the line is restarted centrally to sign on again, or 
check with the central operator. 

1R18I REMOTE remid FORCED TO SIGN OFF 

Cause: For n minutes no activity has taken place on the line (n is specified in the 
POWER/VS option TIMEOUT). 

System Action: The terminal becomes inactive. 
Operator Action: None. 
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1R19I FIRST CARD MUST BE SIGNON COMMAND 

Cause: The first card in the input stream from a terminal that is currently not 
signed on is not a SIGNON command. 

System Action: Flush the input stream. 
Operator Action: Enter a SIGNON command. 

1R20I MESSAGES DELETED 

Cause: There is not enough room in the message queue for all the messages 
(probably due to the printer not being ready). 

System Action: The messages for the remote-ID who is monopolizing the queue 
are deleted. 

Operator Action: None. 

1R21I SIGNON IGNORED. INVALID REMOTE-ID 

Cause: The remote-ID specified in the SIGNON command is not known to 
POWER/ VS or is not associated with this terminal. 

System Action: Flush the input stream. 
Operator Action: Enter a valid SIGNON command. 

1R22I SIGNON IGNORED. INVALID PASSWORD 



Cause: The security password specified in the SIGNON command does not match 
the password that the central operator defined for this line or the default pass- 
word specified during POWER/VS generation. 

System Action: Flush the input stream. 

Operator Action: Enter a valid SIGNON command. 



1R24I {START/ COMMAND OUT OF SEQUENCE 

{STOP [ 
(GO ) 



Cause: A command is entered at the wrong time. For example, a START command 
is issued on an active task, or another task management command is issued on an 
inactive task. 

System Action: The command is ignored. 

Operator Action: Correct the sequence of commands. 
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Command Processor Messages 



1R46I /status report 



i 



(NOTHING TO DISPLAY 



Cause: The status report is printed as a result of a PDISPLAY command. 
System Action: none. 
Operator Action: none. 

1R47I /ttt,cuu message \ 

\NO MESSAGES PENDING/ 

Cause: The PDISPLAY M command was issued. 

System Action: The system lists all messages for which deferred operator reply 
is still required. 

Operator Action: None. (Only after the entire list has been printed can you 
enter commands.) 

1R48I (ttt, cuu class [jobname jobnumber class] I 

\NO READER OR WRITER TASK CURRENTLY ACTIVE/ 

Cause: The PDISPLAY A command was issued. 

System Action: All active reader/writer tasks in the system are listed together 
with the classes on which they can operate. (For a physical list or punch task 
the jobname, jobnumber and class from the queue record being processed are 
also displayed.) 

Operator Action: None. 



1R49I FREE RECORDS QUEUE FILE nnnnn 
1R49I /ACCOUNT FILE nn% FULL \ 
\NO ACCOUNTING SUPPORT/ 



Cause: The system responds to a PDISPLAY Q command. 
System Action: None. 
Operator Action: None. 



1R50D pp READER= 
1R50D pp PRINTERS= 
1R50D pp PUNCHES= 



Cause: Message 1R86I PLEASE SPECIFY DEVICES TO BE SPOOLED has just 
been issued. 

System Action: The system waits for the operator's response. 

Operator Action: Specify the physical devices to be spooled for the given partition. 
Specify the physical device address in the form cuu (channel and unit number). 
For READER, you can specify only one cuu or NO (NO defines a writer-only 
partition). If more than one printer or punch is to be spooled, separate the device 
addresses by a comma (up to eight device addresses may be specified). 
By specifying both PRINTERS and PUNCHES as NO you define a reader-only 
partition. NO can be specified once or twice, but must not be specified all three 
times. 
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1R51I commandcode OPERAND 1 DESIGNATES NON-EXISTING TASK 

Cause: The task specified in a task management command does not exist. , 

System Action: The task management command is not executed. 
Operator Action: None. 

1R52I commandcode syntax error 

Cause: A syntax error was made in an operator command. The syntax error may 
be one of the following: 

NO SECOND OPERAND ALLOWED FOR PSTOP PARTITION 

OPERAND 2 NEITHER DECIMAL NOR OMITTED 

OPERAND n IS INVALID HEXADECIMAL TERM 

OPERAND 2 NEITHER DECIMAL NOR OMITTED 

OPERAND 2 NEITHER 'HOLD' NOR OMITTED 

NO VALID KEYWORD SPECIFIED 

OPERAND n NOT SPECIFIED AS KEYWORD 

OPERAND 1 INVALID DESTINATION 

OPERAND n IS INVALID KEYWORD 

OPERAND 1 MISSING OR INVALID 

OPERAND 2 NO DEVICE ADDRESS 

OPERAND 2 NO VALID JOBNAME 

OPERAND 1 NO VALID QUEUE 

INVALID NUMBER OF COPIES 

OPERAND 1 NOT 'STATUS' 

SECOND OPERAND INVALID 

OPERAND 3 NOT DECIMAL 

INVALID DISPOSITION (j 

INVALID REMOTE ID 1 

OPERAND 1 INVALID 

OPERAND 2 INVALID 

INVALID PRIORITY 

INVALID CLASS 

System Action: The command is not executed. 

Operator Action: Re-issue the corrected command. 

1R53I PACCOUNT INVALID DENSITY 

Cause: The tape density specified in a PACCOUNT (or J) command was invalid. 

System Action: The command is not executed. 

Operator Action: Re-issue the command with the correct tape density. 

1R54I commandcode CLASS x INVALID 

Cause: An invalid class was specified in a PSTART command. 

Valid classes are as follows: 

physical reader A - Z, - 4 

physical writer A - Z (1 to 4 alphabetic characters) 

execution reader A - Z, - 4 (1 to 4 alphameric characters). (0 for BG, 1 for 

Fl, 2 for F2, 3 for F3, or 4 for F4) g 
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System Action: The PSTART command is not executed. 

Operator Action: Omit or correct the class in the PSTART command. (The default 
is A, except for the execution reader, whose default matches the partition (0 for 
BG, 1 for Fl, etc.) 

1R55I PACCOUNT INVALID FILENAME 

Cause: The filename specified in the PACCOUNT (or J) command is invalid. 

System Action: The command is not executed. 

Operator Action: Re-issue the corrected PACCOUNT command. 

1R56I xxx DOES NOT OCCUR IN RJE LINE TABLE 1 
PROCESSING yyy 
NOT INITIATED 
INACTIVE 



Cause: The central operator issued a PINQUIRE command. 

One message is issued for each RJE line address (xxx), or as specified. The 

meanings of each message text follow: 

(a) DOES NOT OCCUR IN RJE LINE TABLE means that no PLINE macro was 
submitted for this RJE line address during POWER/VS generation or that the line 
address is' not present in the PUB table. 

(b) PROCESSING yyy indicates that a user (remote-ID yyy) is currently signed on. 

(c) NOT INITIATED means that the line was started, but no remote-id is signed 
on. 

(d) INACTIVE means that the line was not started by the central operator (no 
PSTART was given). 

System Action: Processing continues. 

Operator Action: None. 

1R57I commandcode COMMAND IGNORED, TASK IS AT JOB BOUNDARY 

Cause: The PFLUSH or PRESTART command was issued for a task that has 
already reached end-of-job. 

System Action: The command is not executed. 

Operator Action: None. 

1R58I commandcode DEVICE xxx (NOT KNOWN) 

<IN USE [ 

(IS DOWN ) 



Cause: The device (xxx) specified in the command does not occur in the PUB 
table in the DOS/VS supervisor, or is not available for use, or is down. 

System Action: The command is not executed. 

Operator Action: If the device is present and available, re-IPL and add the device 
to the PUB table. Otherwise, when the device is available, resubmit the command. 
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1R59I commandcode OPERAND 2 IGNORED 

Cause: Two printer addresses were specified on a PEND command; only one is 
allowed. 

System Action: If the first operand is correct, the command is executed. Other- 
wise, the command is not executed. 

Operator Action: If the command was not executed, correct the command and 
resubmit it. 

1R61I PFLUSH INVALID FOR WRITER-ONLY PARTITION 

Cause: The PFLUSH command was issued for a writer-only partition (one that 
was started with READER=NO). 

System Action: The PFLUSH command is ignored and processing continues. 

Operator Action: None. 

1R62I commandcode INVALID RJE PASSWORD 

Cause: The password of a PSTART command for an RJE line was longer than 8 
characters. 

System Action: The command is not executed. 

Operator Action: Re-enter the PSTART command with the correct password. 

1R63I commandcode xx PRIORITY TOO HIGH 

Cause: A PSTART command was issued for a partition whose priority is not lower 
than the priority of the POWER/ VS partition. 

System Action: The PSTART command is not executed. 

Operator Action: Change the priority of the partitions with the PRTY attention 
command and then re-issue the PSTART command. 

1R64I commandcode /SYSLST LUB NOT AVAILABLE* 

\NO FREE LUB AVAILABLE / 

Cause: Self-explanatory. 

System Action: The command is not executed. 

Operator Action: Wait until a reader or writer task stops at which time a LUB 
will become available, or issue a PSTOP command for a physical reader or writer 
task. Then re-issue your original command. 

1R65I commandcode RJE NOT SUPPORTED 

Cause: An RJE command was issued in a non-RJE environment (no PLINE macros 
were specified during POWER/VS generation). 

System Action: The command is not executed. 

Operator Action: None. 
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< 



1R66I commandcode Jxxx LIST WRITER TASK DOES NOT EXIST) 

\NO WRITER TASK SPECIFIED / 



Cause: A PSETUP or PRESTART command specified something other than a list 
writer task, or the writer task specification was omitted. 

System Action: The command is not executed. 

Operator Action: Correct the command and resubmit it. 

1R67I commandcode /OPERAND 2 REDUCED TO 9999 \ 

) NUMBER OF PAGES REDUCED TO 99 f 

Cause: In the PRESTART command the number of pages or cards specified was 
greater than 9999, or in the PSETUP command the number of pages specified was 
greater than 99. 

System Action: Self-explanatory. 

Operator Action: None. 

1R68I commandcode pp PARTITION NOT AVAILABLE 



Cause: A PSTART command was issued for a partition that was already active. 

System Action: The command is not executed. 

Operator Action: Issue PDISPLAY A to check if the partition is already under 
POWER/VS control, then PSTOP it if necessary (to change the class specification 
in a new PSTART command). If the partition is not under POWER/VS control, 
wait until the current job finishes, issue STOP, and re-issue the PSTART command. 

1R69I commandcode NO ACCOUNTING SUPPORT 

Cause: The PACCOUNT command was entered, but ACCOUNT=YES was not 
specified during POWER/VS generation. 

System Action: The PACCOUNT command is ignored. 

Operator Action: None. 

1R70I commandcode NO DEVICE ADDRESS SPECIFIED 

Cause: The first operand of a PRESTART command was not a device address. 
System Action: The PRESTART command is not executed. 
Operator Action: Re-issue the corrected PRESTART command. 

1R71I commandcode OPERAND x IS NO VALID READER/PRINTER/PUNCH 

Cause: The operator response to message 1R50D is invalid. It must be NO or an 
applicable device address. 

System Action: The system keeps prompting until a satisfactory reply is given. 

Operator Action: Specify a correct device address or NO. 
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1R72I commandcode VIRTUAL xx SMALLER THAN 64K 

Cause: The minimum size of a virtual partition to be started is 64K bytes. 

System Action: The PSTART command is not executed. 

Operator Action: Use the ALLOC command to change the partition size and then 
re-issue the PSTART command. 

1R73I commandcode INVALID DEVICE TYPE FOR (RDR) 

< LST > 

(pun) 

Cause: Operands 1 and 2 of a PSTART command are inconsistent (you cannot 
read from a printer or write on a card reader). 

System Action: The PSTART command is not executed. 

Operator Action: Issue a valid PSTART command. 

1R74I fPEND OPERAND n INVALID PRINTER SPECIFICATION! 
(PACCOUNT INVALID TAPE SPECIFICATION / 

Cause: Either operand n (1 or 2) in the PEND command was not the address of 
a printer, or in the PACCOUNT command an invalid tape address was specified. 

System Action: The PEND or the PACCOUNT command is not executed. 

Operator Action: Re-issue the corrected command. 

1R75I pp AUTOSTARTED 

Cause: The PSTART control card that was issued on SYSIPT has been processed 
for the pp partition. 

System Action: Processing continues. 

Operator Action: None. 

1R76I commandcode NUMBER OF PAGES NOT DECIMAL 

Cause: The number of pages specified in the PSETUP command was not specified 
in decimal notation. 

System Action: The PSETUP command is not executed. 

Operator Action: Re-issue the corrected command. 

1R77I commandcode TASK NOT WAITING FOR OPERATOR 

Cause: A PSETUP or PGO command was issued for a task that is not waiting for 
operator response. 

System Action: The command is not executed. 

Operator Action: None. § 
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1R78I commandcode SHORT 'PEND' NO LONGER SUPPORTED 

Cause: The E command was given. 

System Action: The command is not executed. 

Operator Action: Issue a PEND command. 

1R79I commandcode ERRONEOUS AUTOSTART CARD(S) READ 

Cause: During the AUTOSTART procedure an invalid PSTART command was de- 
tected, or an invalid spool device was specified for a partition to be started.^ 

System Action: If the partition cannot be started, the command is not executed. 
If an invalid spool device was indicated, message 1R86D prompts the operator 
again to specify devices to be spooled. 

Operator Action: None. 
1R80I commandcode WARNING: CLASS SPECIFICATION IGNORED 



Cause: The PSTART command with a class parameter was issued for a partition 
which is under POWER/VS control already, but which had been stopped with a 
STOP command (not PSTOP). 

System Action: This PSTART command is equivalent to a DOS/VS START 
command, that is, the partition is activated, but the classes that applied to the 
previous PSTART command are still applicable. 

Operator Action: None, unless the classes are not suitable, in which case issue 
PSTOP and then re-issue the desired PSTART command. 

1R81I commandcode /MESSAGE DOES NOT START WITH QUOTE ) 

(MESSAGE TOO LONG OR NO CLOSING QUOTE/ 

Cause: Self-explanatory. 

System Action: The command is not executed. 

Operator Action: Re-issue the PBRDCST command with the message enclosed in 
quotes. 

1R82I commandcode 'PSETUP' OR 'PRESTART' IN PROGRESS 

Cause: A PRESTART command was issued, but a PSETUP or PRESTART 
command is going on. 

System Action: The PRESTART command is not executed. 

Operator Action: Issue the PRESTART command again later. 

1R83I commandcode OPERAND NEITHER 'ALU NOR LINE ADDRESS 

Cause: The PINQUIRE command was incorrect. 
System Action: The command is not executed. 
Operator Action: Re-issue the PINQUIRE command with the operand corrected. 
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1R84I commandcode DELETION NOT ALLOWED OR IMPOSSIBLE 

Cause: The alluser message that was to be deleted does not exist or was not sent 
by the issuer of the PDELETE command. 

System Action: The command is not executed. 

Operator Action: None. 

1R85I commandcode COMMAND INVALID FOR REMOTE OPERATOR 

Cause: The GO, END, or ACCOUNT command was issued by the remote operator. 
System Action: The command is not executed. 
Operator Action: None. 

1R86D PLEASE SPECIFY DEVICES TO BE SPOOLED 

Cause: A PSTART command has been entered for a partition. 
System Action: Message 1R50D is issued immediately. 
Operator Action: None. 

1R87I commandcode TOO MANY CLASSES, ONLY FIRST n PROCESSED 



Cause: In a PSTART command more than one class was specified for a reader 
task, or more than four classes were specified for a writer or execution reader 
task. 

System Action: The extra classes are ignored. 

Operator Action: If this is not acceptable, issue a PSTOP command, followed by 
a new PSTART with the correct classes. 



1R88I (NOTHING TO RELEASE 
[NOTHING TO DELETE 

CANNOT BE ALTERED 
I JOB jobname jobnumber NOTHING TO ALTER 

CP READY 



Cause: The job specified in the PALTER command is being processed, or the job 
specified in the PALTER, PDELETE, or PRELEASE command is not present in 
the specified queue. 

System Action: The command is not executed. For CP READY, the previous 
command has been processed. 

Operator Action: None. If CP READY is the message text, you can issue another 
command. 
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1R89I commandcode POWER/VS INITIALIZATION NOT COMPLETED 

Cause: The PEND command was given before POWER/VS initialization was 
complete. 

System Action: The PEND command is not executed. 

Operator Action: Wait until the initialization is finished before you try to issue 
PEND again. 

1R90I commandcode INVALID TASK SPECIFICATION, operand 

Cause: The first operand of a PSTART command was neither RDR, LST, PRT, 
PUN, RJE, BG, nor Fn. The invalid operand is shown in the message. 

System Action: The command is not executed. 

Operator Action: Correct the PSTART command and re-issue it. 

1R91I commandcode TOO MANY OPERANDS, FIRST n PROCESSED 

Cause: Self-explanatory. 

System Action: The extra operands are ignored. 

Operator Action: None. 

1R92I ALLUSER MESSAGE QUEUE IS FULL 



Cause: Self-explanatory. 

System Action: The PBRDCST command is not executed. 

Operator Action: Issue a PDISPLAY MSG to see what is in the queue, use the 
PDELETE MSG command to make space in the queue, and then re-issue the 
PBRDCST command. 



1R93I REMOTE remid CURRENTLY NOT SIGNED ON 

Cause: The PBRDCST command submitted refers to a remote-ID that is not signed on. 
System Action: The message is not sent to the remote-ID. Processing continues. 
Operator Action: To find out who is signed on, issue a PINQUIRE ALL. 



1R97I commandcode COMMAND INVALID DURING SHUTDOWN PERIOD 

Cause: Either a PSTART, PEND, PALTER, PRELEASE, or PDELETE command 
was issued during the shutdown period. 

System Action: The command is not executed. 

Operator Action: None. 
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1R98I commandcode INVALID POWER/VS COMMAND CODE 

Cause: Some command was issued that is not known to POWER/VS. 
System Action: The command is not executed. 
Operator Action: Submit a correct command. 



1R99I ( POWER/VS IS IN THE SHUTDOWN PERIOD! 
J POWER/VS HAS BEEN TERMINATED j 



Cause: The PEND command was issued by the central operator, or PEND KILL 
was issued by the central operator. 

System Action: Processing continues. 

Operator Action: None. 



1 8.28 DOS/VS POWER/VS Installation and Operations 



CHANGES TO OTHER DOS/VS MESSAGES 



The following DOS/VS messages have been expanded for POWER/ VS: 

0S01I 

lA7nD/I 

lC5nI. 

0S0 1 1 JOB or SUB xxxxxxxx CANCELED DUE TO OPERATOR INTERVENTION 

Cause: Operator typed CANCEL on the console keyboard to cancel a job, or the job 
has been flushed under POWER/VS. 

Note: A separate subtask cannot be canceled by the operator. When the operator types 
CANCEL on the console -typewriter, the job is canceled due to operator intervention, and 
the subtasks are canceled due to maintask termination. 

System Action: The job is canceled. 

Programmer Action : None . 

Operator Action: None. 



lA7nD/I INVALID DEVICE STATUS 

n indicates the field processed when the error was detected. 

Cause: The previous ASSGN attempted to assign a physical unit that is in a 'down' or 
'not operational' status resulting from a DVCDN command, or 

The previous ASSGN attempted to assign SYSLNK or SYSCLB to a physical unit that 
is in a 'down' status resulting from a DVCDN command, or 

The device specified in the DVCUP command was never previously placed in a down 
status by a DVCDN command, or 

The previous MTC command specified a physical device assigned to a foreground program, or 

The DVCDN command was issued for a device owned by POWER/VS. 

System Action: If SYSLOG is assigned to a keyboard, the system waits for an operator 
response; otherwise, the invalid command or statement is ignored. If option ACANCEL is 
in force the job is canceled. 

Programmer Action: None. 

Operator Action: Issue a LISTIO command and use the output to determine which cause 
applies in this case. If you attempted to assign SYSPCH or SYSLST to a file protected 
tape, either mount a new tape or insert a file protect ring in the mounted tape, and reissue 
the ASSGN command, or 

Type in a new assignment, 

Type IGNORE or press END/ENTER to ignore the statement or command if you can do 
without it, and continue processing, or 

Type CANCEL to cancel job. 

If the problem recurs, have the 

. . LISTIO output 
log sheet 
job stream 

available for problem determination. 
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lC5nI PROCESSING ROUTINE ACTIVE 

n indicates the field processed when the error was detected. 

Cause: External interrupt given, and external interrupt routine is currently 
active, or MSG command given, and foreground partition external interrupt 

I routine is active, or a POWER/ VS command was entered while the POWER/VS 
command processor was processing the previous command. 

System Action: Processing continues. 

Programmer Action: Check that an EXIT has been included for each STXIT 
| (not applicable to POWER/VS). 

Operator Action: Check that the MSG command was issued to the correct 
foreground partition or that the external interrupt key (see the operating 
procedures for your System/370 Model) was used to communicate with the 

I background partition. For POWER/VS, wait for message 1R88I CP READY 

J before entering the next command. 
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account records, contents of 8.1 
account file 

delete 6.15 

description 2.8, 2.3 

formatting of 4.6 

jobs capacity 3.14 

labels, example 3.8 

save 6.15 

size requirement 3.13 
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disposition 2.9 
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book statement 

delete 5.15 

insert 5.15 

replace 5.15 
BRDCST command 7.12 



broadcast message(s) 
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job entry 6.7 

job, RJE 7.5 
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alter 6.12 
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job 1.3, 2.9 
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print 1 .4 

priority 2.9 

punch 1 .4 
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specification 2.9, 5.3 
code(s) 
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operator commands 6.1 
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SIGNOFF 10.1 

transmission, specify 3.5 
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ALTER 7.9 

BRDCST 7.12 
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DISPLAY 7.5 
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GO 7.5 
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PACCOUNT 6.15 

PALTER 6.11 
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PSTOP 6.5 

queue management 6.9 
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STOP 7.4 

summary 2.10 
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conventions, commands and statements i 
copies 

alter number of 6.12 
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D attribute 2.9 
DASD (see disk) 
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block 3.2 
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block, storage requirement 3.11 

flow, POWER/VS 2.1 

transmission mode 1.5 
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DBLK 
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dispatching priority 4.7 
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cancel PDISPLAY 6.7 
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job number, specify 3.4 
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status, RJE 7.7 
DISPLAY command 7.6 
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alter 6.12 

alter, RJE 7.9 

input, specify 5.4 
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list, specify 5.8 
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distributed POWER/VS program 3.8 
DOS/VS 

JCL modification 2.1 
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assignment 2.11 
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LST statement 5.7 
dump, POWER/VS termination 6.6 



early print start (see segmentation) 

EBCDIC 3.5 

end (see stop, terminate or cancel) 

end job 5.5 
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definition 2.5 

delete, RJE 7.9 

flush, RJE 7.5 

LUB 3.9 
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system, storage requirement 3.12 
EOJ statement 
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I/O, cancel code 9.1 
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execution 
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list task 2.3 

processor 2.3 

punch task 2.3 

read task 2.3 
extents of POWER/VS files 3.8, 3.10, 2.5, 2. 
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FCB 

phasename, specify 5.10 

support 2.12 
features of POWER/VS 1.3 
fields of JECL statements 5.2 
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account file (see account file) 

data file (see data file) 

extents, example 3.8 

labels, example 3.8 

organization 2.5 

queue file (see queue file) 

size requirement 3.13 
fixable area 3.10 
FLUSH command 7.5 
flush 

task 6.7 

task, RJE 7.5 
format 

files, POWER/VS 4.1,4.51 

format statement 4.6 

JECL statements 5.2 

of commands 6.1 

of RJE commands 7.1 
FORMAT statement 

AUTOSTART procedure 4.5 

format of 4.6 
forms 

card, specify 5.13 

printer, setup 6.16 

printer, specify 5.9 
forms control 

line table 5.10 

LTAB parameter 3.2 
functions 

POWER 2.1 



G 

generation 

examples 17.1 
file labels example 3.8 
DOS/VS supervisor 3.8 
POWER macro 3.1 
POWER/VS 3.1 
pre-assembled POWER/VS 3.8 
macros 3.1 



GO command 7.5 



H 

H attribute 2.9 
hardware device support 2.11 
hints (see considerations) 
HOLD state 

release 6.14 
hot reader 1.5 
hot writer 1.5, 7.2 



I 

I attribute 2.9 

idle RJE terminal 1.5, 7.2 

initialize 

POWER/VS 4.3 
input 

class, specify 5.4 

disposition, specify 5.4 

priority, specify 5.4 
insert 

book statement 5.15 

deck into source book 5.15 

source book 5.15 
interactive data communications 4.7 
intermediate storage 2.1 
inter-partition device assignment 2.10 



JAI (see job accounting) 

JCL modification 2.1 

JECL (see job entry control language) 

job(s) 

account file capacity 3.14 

attributes (see attributes) 

entry (see entry) 

name, specify 5.4 

number 3.4 

separator 1 .4 
job accounting 

adding user information 13.1 

processing records 2.8 

record, contents of 8.1 

record types 2.8 

save account file 6.15 

support, specify 3.3 

support, storage requirement 3.10 

SJOBACCT 13.1 
job entry control language 

delimit jobs 5.1 

function 5 ,1 

list of statements 5.1 

positional parameters 5.2 

statement formats 5.2 

treated as comments 5.1 
job number 

display, specify 3.4 
JOB statement 5.3 
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job stream(s) 

delimit POWER/VS job 
example 2.7, 15.1 
processing 1.1 



5.3 



K 

K attribute 2.9 
KILL POWER/VS 



6.6 



L attribute 2.9 

LFCB 2.5, 5.10 

LEAVE state, release 6.14 

limit 

card images, specify 3.3 

list records, specify 5.9 

output records 2.10 

print lines, specify 3.3 

punch records, specify 5.14 
line(s) 

account record 8.5 

RJE, define 3.5 

RJE, number of 1.5 

RJE, start-up 7.2 

RJE, timeout 3.5 
line table 

LTAB, specify at generation 3.2 
list 

account record 8.2 

entry 2.5 

queue entry 2.5 

queue' set 2.5 

tasks 2.3 
logical 

list 2.3 

punch 2.3 

read 2.3 
LST statement 

format 5.7 

function 5.7 



M 

macro(s) 

PLINE 3.5 

POWER 3.1 

POWER/VS generation 3.1 

PRMT 3.6 
main storage requirements 3.10 
message(s) 

broadcast 6.14, 7.4 

display 6.10 

format files 4.3 

operator 18.1 

POWER/VS 18.1 

remote 7.1, 7.12 
modify book images 5.15 
multitasking support 2.1, 12.1 



multiple 

devices 1.3 

list copies, specify 5.9 

printers 1,3, 5.7 

punch copies, specify 5.13 

punches 1 .3 
multivolume tape files 5.9, 5.13 



N 

N attribute 2.9 
name 

logical unit, POWER/VS files 2.5, 2. 
notation conventions / 
number-of-copies (see copies) 



object deck(s), transmit 3.5 
operator commands (see commands) 
operator messages 18.1 
output 

destination 2.10 

direct list 5.8 

limit 2.10 

list, attributes 5.7 

remote list 5.9 

remote punch 5.13 

segmentation (see segmentation) 

tape spooling 5.8 



PACCOUNT command 6.15 
page separator 5.9 
pageable area 3.10 
PALTER command 6.11 
partition(s) 

layout, POWER/VS 3.10 

POWER/VS controlled 2.1 

size, POWER/VS 4.1, 4.5 

start 6.2 

stop 6.5 
password 3.5, 6.3, 7.3 
PBRDCST command 6.15 
PCANCEL command 6.7 
PDELETE 6.13 
PDISPLAY 

cancel 6.7 

format of command 6.9 

function 6.9 
PEND command 6.6 
permanent area 3.10 
PFLUSH command 6.7 
physical 

list 2.3 

punch 2.3 

read 2.3 
PINQUIRE command 6.14 
PLINE macro 3.5 
POCL (see commands) 
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positional parameters, JECL statements 5.2 


program, pre-assembled POWER/VS 


POWER macro 3.1 




PRT statement 5.7 


POWER/VS 




PSETUP command 6.16 


commands 2.10 




PSTART 


compare with DOS/VS POWER 12.1 


AUTOSTART procedure 4.3 


concepts 2.1 




command 6.5 


control language 2.10 




RJE lines 4.5 


data flow 2.1 




PSTOP command 6.5 


definition 1.1 




PUN statement 5.11 


device support 2.11 




punch(es) 


disk files 2.3 




account record 8.3 


facilities 2.1 




dummy 2.10, 2.11 


features 1 .3 




entry 2.5 


file extents 2.5, 2.8 




queue entry 2.5 


file labels, example 3.8 




queue set 2.5 


file requirements 3.13 




supported devices 2.11 


functions 2.1 




PUNCHES statement 4.6, 2.1 


initialize 4.3 




punching 


introduction 1.1 




restart, RJE 7.6 


JECL statements 5.1 




PUTACCT macro 13.1 


job delimiters 5.3 






operator commands (see 


commands) 




operator messages 18.1 






pre-assembled program * 


3.8 


Q 

queue(s) 
display 6.9 
entries 2.5 


processing with, without 
queues 2.9 
start-up 4.1 


1.1 


tasks 2.1 




file organization 2.5 


termination 6.6 
pre-assembled POWER/VS 3.8 
PRELEASE command 6.14 
print (see list) 


management commands 6.9 
POWER/VS 1.3, 2.9 
record 2.5 
set 2.5 


print lines 

limit, specify 3.3 




queue file 

definition 2.3 


printer(s) 




extents 2.5 


dummy 2.10, 2.11 




labels, example 3.8 


supported devices 2.11 




logical unit name 2.5 


UCS 2.12 
printer forms 
FCB 2.12 
specify 5.9, 1.4 




organization 2.5 
size requirement 3.13 
queue records 

table, by device 3.14 


setup 6.16 






setup, RJE 7.12 






PRINTERS statement 4.6, 


2.1 




printing 




R 


restart, RJE 7.6 




PRESTART command 6.8 




RDR statement 5.5 


priority 




RDREXIT 


alter 6.12 




coding of 14.1 


alter, RJE 7.9 




storage requirement 3.10 


attribute 2.10 




support, specify 3.4 


class 2.9 




read 


default, specify 3.2 




account record 8.1 


dispatching 2.1 




entry 2.5 


input, specify 5.4 




queue entry 2.5 


jobs 1.3 




queue set 2.5 


partitions 4.1,4.7 




tasks 2.3 


specification 2.10 




READER statement 4.6, 2.1 


PRMT macro 3.6 




reader(s) (see also read task) 


procedure(s) 




supported devices 2.11 


start-up with AUTOSTART 4.3 


reader-only support 4.6 


start-up without AUTOSTART 4.1 


real mode 2.1 



3.8 
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real storage 

ALLOCR 3.10 

ALLOCR, start-up 4.1,4.5 
record(s) 

account 8.1 

account file, types 2.8 

list, specify 5.9 

output limit 1.4 

punch, specify 5.14 

queue 2.5 

queue file, size 2.5 
re-display 

messages 6.11 
release 

job entry 6.14 

job entry, RJE 7.11 
RELEASE command 7.11 
remote 

output, list 5.9 

output, punch 5.13 
remote-id 

alter 6.12 

alter, RJE 7.9 

sign on terminal 7.3 
remote job entry (see RJE) 
replace book statement 5.15 
report 

status, example 11.1 

status, RJE line 6.14 
reprint 6.8 
restart 

list/punch task 6.8 

POWER/VS 1.3 

printing 1 .4 

PSTOP parameter 6.5 

punching 1.4 

task at stopping point 6.5 

task at stopping point, RJE 7.5 

write task, RJE 7.6 
RESTART command 7.6 
return codes 

RDREXIT 14.1 
RJE 

commands, list 7.1 

device support 2.12 

facilities 1 .5 

hardware feature support 1.5 

line, define 3.5 

lines, number of 1.5 

operational characteristics 7.1 

PLINE macro 3.5 

SIGNOFF codes 10.1 

start task 6.2 

status report 6.14 

storage requirement 3.10 

tasks 2.3 
ROCL (see commands) 
routine(s) 

RDREXIT 14.1 

SJOBACCT 1.3.1 



save account file 6.15, 2.8 
segmentation 

attribute 2.10 

definition 2.5 

feature 1.1 

list output, specify 5.10 

punch output, specify 5.14 

separator pages/cards 3.4 

specify at generation 3.4 
separator 

cards, specify 5.13 

cards, specify at generation 3.4 

job 1.4 

page, specify 5.9 

pages, specify at generation 3.4 
sequence field, JECL statements 5.3 
setup 

printer forms 6.16 

printer forms, RJE 7.12 
SETUP command 7.12 
sign off terminal 7.3 
SIGNOFF 

codes 10.1 

command 7.3 
sign on terminal 7.3 
SIGNON command 7.3 
six-bit transmission code 3.5 
SL update statement 5.15 
SLI support, specify 3.3 
SLI statement 5.14 
source 

book, specify 5.14 

library inclusion 5.14, 1.3 

library update statements 5.15 

library, SUBLIB 3.3 
split cylinders 2.5 
spool 

device specification 4.6 

tape, specify for list 5.8 

tape, specify for punch 5.13 
spooling 

definition 1.1 

devices 2.11 
stacker select 

device support 2.11 

input 2.1 
start : 

partition 6.2 

RJE task 6.2 

task 6.2 

write task, RJE 7.4 
START command 7.4 
start-up 

considerations 4.7 

POWER/VS 4.1 

RJE lines 7.2, 4.5 

with AUTOSTART 4.3 

without AUTOSTART 4.1 



( 
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statement(s) 






teleprocessing (see RJE) 


address specification 


4.6 




terminal 


FORMAT 4.6 






characteristics, specify 3.6 


JECL (see job entry control language) 


commands 7.3 


PRINTERS 4.6 






identification 7.3 


PUNCHES 4.6 






operation 7.2 


READER 4.6 






supported devices 2.11 


statistics 






terminate 


files, example 11.1 






POWER/VS 6.6 


status report 






PDISPLAY 6.7 


example 11.1 






session 7.3 


RJE 6.14, 7.6 






timeout 


stop 






RJE lines, specify 3.5 


command, DOS/VS 


6.5 




track group(s) 


partition 6.5 






definition 2.7 


POWER/VS 6.6 






disk requirements 3.13 


session 7.3 






file labels example 3.8 


task 6.5 






TRACKGP parameter 3.2 


write task 7.4 






transparency support 3.5 


STOP command 7.4 






turn-around RJE line 7.2 


storage 








intermediate 2.1 








requirement, disk 3.13 






requirement, main 


3.10 




U 


requirement, POWER/VS 


2.11 


ucs 


sublibrary 






phasename, specify 5.10 


SLI statement 5.14 






support 2.12 


SUBLIB parameter 


3.3 




UNBATCH command 6.5 


supervisor 






unit-record device(s) 


DOS/VS generation requirements 3.9 


assignments in supervisor 


standard defaults for POWER/VS 4.7 


spooled, specify 4.6 



T attribute 2.9 
table(s) 

deblock defaults 3.2 

device support 2.11 

display items, RJE 7.7 

feature support, devices 2.11 

JECL statements 5.1 

job accounting 8.1 

job entry display 6.9 

line table 3.2, 5.10 

operator commands 6.1 

POWER/VS storage requirements 3.10 

queue records by device 3.14 

RDREXIT, return codes 8.1 

RJE commands 7.1 
tape 

intermediate storage 2.1 

spool list output 5.9 

spool punch output 5.13 

spooling, specify for list 5.8 
task 

flush 7.5 

management commands 6.2, 6.1 

POWER/VS 2.1 

restart 6.8 

restart, RJE 7.6 

starting 6.2 

stop 6.5 



user information 

account records 8.1 
RJE, specify 7.3 
specification 5.5 

user routine (s) 
SJOBACCT 13.1 
RDREXIT 14.1 



V 

Virtual 

mode 1.3, 2.1 

storage ALLOC 3.10 

storage, ALLOC at start-up 4.1 



W 

write task 

start 6.2 

start, RJE 7.4 

stop, RJE 7.4 

stop 6.5 
writer (see write task) 
writer-only support 4.6 
writer-only partition 

definition 1.3 

DATA statement 5.15 

JECL 5.1 
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2311 disk support 12.1 
3540 diskette 

input from 5.5 

RDR statement 5.5 

start read task 6.4 

support 2.12 
3780 component selection 3.8 
$JOBACCT 

account record 8.4 

coding of 13.1 

* $$ /* statement 5.15 

* $$ /& statement 5.15 
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